@homenshum/convex-mcp-nodebench 0.1.0

package/README.md

@@ -0,0 +1,137 @@
+# convex-mcp-nodebench
+
+Convex-specific MCP server applying NodeBench self-instruct diligence patterns to Convex development. Schema audit, function compliance, deployment gates, persistent gotcha DB, and methodology guidance.
+
+**Complements** Context7 (raw library docs) and the official Convex MCP (deployment introspection) with structured verification workflows and persistent Convex knowledge.
+
+## 11 Tools across 5 Categories
+
+### Schema Tools
+| Tool | Description |
+|------|-------------|
+| `convex_audit_schema` | Scan schema.ts for anti-patterns: deprecated validators, reserved field names, missing indexes, naming violations |
+| `convex_suggest_indexes` | Analyze query patterns across all functions and suggest missing indexes |
+| `convex_check_validator_coverage` | Check all exported functions have args + returns validators |
+
+### Function Tools
+| Tool | Description |
+|------|-------------|
+| `convex_audit_functions` | Audit function registration, missing validators, public/internal misuse, action anti-patterns |
+| `convex_check_function_refs` | Validate api.x.y / internal.x.y references, detect direct function passing |
+
+### Deployment Tools
+| Tool | Description |
+|------|-------------|
+| `convex_pre_deploy_gate` | Pre-deployment quality gate: schema, auth, validators, recent audit results |
+| `convex_check_env_vars` | Check env vars referenced in code exist in .env files |
+
+### Learning Tools
+| Tool | Description |
+|------|-------------|
+| `convex_record_gotcha` | Persist a Convex gotcha/edge case for future reference |
+| `convex_search_gotchas` | Full-text search across known Convex gotchas |
+
+### Methodology Tools
+| Tool | Description |
+|------|-------------|
+| `convex_get_methodology` | Step-by-step guides: schema audit, function compliance, deploy verification, knowledge management |
+| `convex_discover_tools` | Search available tools by keyword, category, or task description |
+
+## Self-Instruct QuickRefs
+
+Every tool response includes a `quickRef` block telling the agent what to do next:
+
+```json
+{
+  "nextAction": "Run convex_check_validator_coverage to ensure all functions have validators",
+  "nextTools": ["convex_check_validator_coverage", "convex_audit_functions"],
+  "methodology": "convex_schema_audit",
+  "relatedGotchas": ["returns_validator_required", "new_function_syntax"],
+  "confidence": "high"
+}
+```
+
+## Pre-Seeded Gotcha Database
+
+Ships with 20 gotchas extracted from Convex best practices:
+
+- `validator_bigint_deprecated` -- Use v.int64() not v.bigint()
+- `undefined_not_valid` -- Use null, never undefined
+- `index_field_order` -- Query fields must match index definition order
+- `no_map_set_validators` -- Use v.record() instead
+- `returns_validator_required` -- Every function needs a returns validator
+- `action_from_action` -- Only cross-runtime, otherwise use helpers
+- And 14 more...
+
+## Quick Start
+
+### Install
+```bash
+cd packages/convex-mcp-nodebench
+npm install
+npm run build
+```
+
+### Run (stdio)
+```bash
+node dist/index.js
+```
+
+### Dev mode
+```bash
+npx tsx src/index.ts
+```
+
+### Add to MCP config
+```json
+{
+  "mcpServers": {
+    "convex-mcp-nodebench": {
+      "command": "node",
+      "args": ["/path/to/packages/convex-mcp-nodebench/dist/index.js"]
+    }
+  }
+}
+```
+
+### First prompt
+```
+Search convex gotchas for "validator" then audit the schema at /path/to/my-project
+```
+
+## Data Storage
+
+Persistent SQLite database at `~/.convex-mcp-nodebench/convex.db`:
+
+- **convex_gotchas** -- Gotcha knowledge base with FTS5 search
+- **schema_snapshots** -- Schema history for diffing
+- **deploy_checks** -- Deployment gate audit trail
+- **audit_results** -- Per-file analysis cache
+
+## Testing
+
+```bash
+npm test
+```
+
+All 15 tests verify tools work against the real nodebench-ai codebase (3,138 Convex functions).
+
+## Architecture
+
+```
+packages/convex-mcp-nodebench/
+  src/
+    index.ts                 -- MCP server entry, tool assembly
+    db.ts                    -- SQLite schema + seed logic
+    types.ts                 -- Tool types, QuickRef interface
+    gotchaSeed.ts            -- 20 pre-seeded Convex gotchas
+    tools/
+      schemaTools.ts         -- Schema audit, index suggestions, validator coverage
+      functionTools.ts       -- Function audit, reference checking
+      deploymentTools.ts     -- Pre-deploy gate, env var checking
+      learningTools.ts       -- Gotcha recording + search
+      methodologyTools.ts    -- Methodology guides, tool discovery
+      toolRegistry.ts        -- Central catalog with quickRef metadata
+    __tests__/
+      tools.test.ts          -- 15 integration tests
+```

package/dist/__tests__/tools.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/tools.test.js

@@ -0,0 +1,267 @@
+import { describe, it, expect, beforeAll } from "vitest";
+import { resolve } from "node:path";
+import { schemaTools } from "../tools/schemaTools.js";
+import { functionTools } from "../tools/functionTools.js";
+import { deploymentTools } from "../tools/deploymentTools.js";
+import { learningTools } from "../tools/learningTools.js";
+import { methodologyTools } from "../tools/methodologyTools.js";
+import { integrationBridgeTools } from "../tools/integrationBridgeTools.js";
+import { cronTools } from "../tools/cronTools.js";
+import { componentTools } from "../tools/componentTools.js";
+import { getDb, seedGotchasIfEmpty } from "../db.js";
+import { CONVEX_GOTCHAS } from "../gotchaSeed.js";
+// Path to the actual nodebench-ai project root
+const PROJECT_DIR = resolve(__dirname, "../../../..");
+beforeAll(() => {
+    getDb();
+    seedGotchasIfEmpty(CONVEX_GOTCHAS);
+});
+describe("Schema Tools", () => {
+    it("convex_audit_schema runs against nodebench-ai", async () => {
+        const tool = schemaTools.find((t) => t.name === "convex_audit_schema");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.error).toBeUndefined();
+        expect(result.summary).toBeDefined();
+        expect(typeof result.summary.totalIssues).toBe("number");
+        console.log(`Schema audit: ${result.summary.totalIssues} issues (${result.summary.critical} critical, ${result.summary.warnings} warnings)`);
+    });
+    it("convex_suggest_indexes runs against nodebench-ai", async () => {
+        const tool = schemaTools.find((t) => t.name === "convex_suggest_indexes");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.error).toBeUndefined();
+        expect(typeof result.totalSuggestions).toBe("number");
+        console.log(`Index suggestions: ${result.totalSuggestions}`);
+    }, 60_000);
+    it("convex_check_validator_coverage runs against nodebench-ai", async () => {
+        const tool = schemaTools.find((t) => t.name === "convex_check_validator_coverage");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.error).toBeUndefined();
+        expect(result.summary).toBeDefined();
+        expect(typeof result.summary.totalFunctions).toBe("number");
+        console.log(`Validator coverage: ${result.summary.argsValidatorCoverage} args, ${result.summary.returnsValidatorCoverage} returns, ${result.summary.oldSyntaxCount} old syntax`);
+    });
+});
+describe("Function Tools", () => {
+    it("convex_audit_functions runs against nodebench-ai", async () => {
+        const tool = functionTools.find((t) => t.name === "convex_audit_functions");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.error).toBeUndefined();
+        expect(result.summary).toBeDefined();
+        expect(typeof result.summary.totalFunctions).toBe("number");
+        console.log(`Function audit: ${result.summary.totalFunctions} functions, ${result.summary.totalIssues} issues (${result.summary.critical} critical)`);
+    });
+    it("convex_check_function_refs runs against nodebench-ai", async () => {
+        const tool = functionTools.find((t) => t.name === "convex_check_function_refs");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.error).toBeUndefined();
+        expect(result.summary).toBeDefined();
+        console.log(`Function refs: ${result.summary.totalReferences} refs, ${result.summary.directPassAntiPatterns} direct pass anti-patterns`);
+    });
+});
+describe("Deployment Tools", () => {
+    it("convex_pre_deploy_gate runs against nodebench-ai", async () => {
+        const tool = deploymentTools.find((t) => t.name === "convex_pre_deploy_gate");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(typeof result.passed).toBe("boolean");
+        expect(result.checks).toBeDefined();
+        expect(Array.isArray(result.checks)).toBe(true);
+        console.log(`Deploy gate: ${result.passed ? "PASSED" : "BLOCKED"} (${result.checks.length} checks, ${result.blockers.length} blockers)`);
+    });
+    it("convex_check_env_vars runs against nodebench-ai", async () => {
+        const tool = deploymentTools.find((t) => t.name === "convex_check_env_vars");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.envFilesFound).toBeDefined();
+        console.log(`Env vars: ${result.envVarsInCode.length} in code, ${result.envVarsInEnvFile.length} in env files, ${result.missingInEnvFile.length} missing`);
+    });
+});
+describe("Learning Tools", () => {
+    it("convex_search_gotchas finds seeded gotchas", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_search_gotchas");
+        const result = (await tool.handler({ query: "bigint deprecated" }));
+        expect(result).toBeDefined();
+        expect(result.totalResults).toBeGreaterThan(0);
+        expect(result.gotchas[0].key).toBe("validator_bigint_deprecated");
+        console.log(`Gotcha search 'bigint deprecated': ${result.totalResults} results`);
+    });
+    it("convex_search_gotchas finds index gotchas", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_search_gotchas");
+        const result = (await tool.handler({ query: "index order field" }));
+        expect(result).toBeDefined();
+        expect(result.totalResults).toBeGreaterThan(0);
+        console.log(`Gotcha search 'index order field': ${result.totalResults} results`);
+    });
+    it("convex_record_gotcha creates and updates", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_record_gotcha");
+        const result1 = (await tool.handler({
+            key: "test_gotcha_vitest",
+            content: "Test gotcha from vitest",
+            category: "general",
+            severity: "info",
+            tags: "test,vitest",
+        }));
+        expect(["created", "updated"]).toContain(result1.action);
+        const result2 = (await tool.handler({
+            key: "test_gotcha_vitest",
+            content: "Updated test gotcha from vitest",
+            category: "general",
+            severity: "info",
+        }));
+        expect(result2.action).toBe("updated");
+    });
+});
+describe("Methodology Tools", () => {
+    it("convex_get_methodology returns overview", async () => {
+        const tool = methodologyTools.find((t) => t.name === "convex_get_methodology");
+        const result = (await tool.handler({ topic: "overview" }));
+        expect(result).toBeDefined();
+        expect(result.title).toContain("Overview");
+        expect(result.steps.length).toBeGreaterThan(0);
+    });
+    it("convex_get_methodology returns schema_audit steps", async () => {
+        const tool = methodologyTools.find((t) => t.name === "convex_get_methodology");
+        const result = (await tool.handler({ topic: "convex_schema_audit" }));
+        expect(result).toBeDefined();
+        expect(result.steps.length).toBeGreaterThan(0);
+        expect(result.tools.length).toBeGreaterThan(0);
+    });
+    it("convex_discover_tools finds schema tools", async () => {
+        const tool = methodologyTools.find((t) => t.name === "convex_discover_tools");
+        const result = (await tool.handler({ query: "schema audit" }));
+        expect(result).toBeDefined();
+        expect(result.matchingTools).toBeGreaterThan(0);
+        console.log(`Discover 'schema audit': ${result.matchingTools} tools found`);
+    });
+    it("convex_discover_tools filters by category", async () => {
+        const tool = methodologyTools.find((t) => t.name === "convex_discover_tools");
+        const result = (await tool.handler({ query: "deploy", category: "deployment" }));
+        expect(result).toBeDefined();
+        expect(result.tools.every((t) => t.category === "deployment")).toBe(true);
+    });
+});
+describe("Integration Bridge Tools", () => {
+    it("convex_generate_rules_md generates rules content", async () => {
+        const tool = integrationBridgeTools.find((t) => t.name === "convex_generate_rules_md");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.action).toBe("generated");
+        expect(result.content).toContain("Convex Development Rules");
+        expect(result.lines).toBeGreaterThan(10);
+        console.log(`Rules generation: ${result.lines} lines`);
+    });
+    it("convex_snapshot_schema captures snapshot", async () => {
+        const tool = integrationBridgeTools.find((t) => t.name === "convex_snapshot_schema");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.snapshotId).toBeDefined();
+        expect(result.tableCount).toBeGreaterThan(0);
+        console.log(`Schema snapshot: ${result.tableCount} tables`);
+    });
+    it("convex_bootstrap_project scans project", async () => {
+        const tool = integrationBridgeTools.find((t) => t.name === "convex_bootstrap_project");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.checks).toBeDefined();
+        expect(result.summary).toBeDefined();
+        expect(result.improvementPlan).toBeDefined();
+        console.log(`Bootstrap: ${result.summary.good} good, ${result.summary.warnings} warnings, ${result.summary.criticals} criticals`);
+    });
+});
+// ── BM25 A/B Comparison Tests ─────────────────────────────────────────────
+import { findTools } from "../tools/toolRegistry.js";
+describe("BM25 Tool Discovery — A/B Comparison", () => {
+    it("ranks exact-name match above tag-only match", () => {
+        const results = findTools("audit schema");
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].name).toBe("convex_audit_schema");
+    });
+    it("uses OR logic — partial terms still return results", () => {
+        const results = findTools("deploy");
+        expect(results.length).toBeGreaterThanOrEqual(2);
+        const names = results.map((r) => r.name);
+        expect(names).toContain("convex_pre_deploy_gate");
+        expect(names).toContain("convex_check_env_vars");
+    });
+    it("field weighting: name > tags", () => {
+        const results = findTools("gotcha");
+        expect(results.length).toBeGreaterThanOrEqual(2);
+        // Both gotcha tools should rank in top 2 (name contains 'gotcha')
+        const top2 = results.slice(0, 2).map((r) => r.name);
+        expect(top2).toContain("convex_record_gotcha");
+        expect(top2).toContain("convex_search_gotchas");
+    });
+    it("IDF: rare term 'bootstrap' ranks convex_bootstrap_project first", () => {
+        const results = findTools("bootstrap");
+        expect(results.length).toBeGreaterThan(0);
+        expect(results[0].name).toBe("convex_bootstrap_project");
+    });
+});
+describe("BM25 Gotcha Search — A/B Comparison", () => {
+    it("FTS5 primary path finds relevant gotchas", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_search_gotchas");
+        const result = (await tool.handler({ query: "validator deprecated bigint" }));
+        expect(result).toBeDefined();
+        expect(result.totalResults).toBeGreaterThan(0);
+    });
+    it("searches across multiple seeded gotchas", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_search_gotchas");
+        const result = (await tool.handler({ query: "function action mutation" }));
+        expect(result).toBeDefined();
+        expect(result.totalResults).toBeGreaterThan(0);
+    });
+    it("category filter works with search", async () => {
+        const tool = learningTools.find((t) => t.name === "convex_search_gotchas");
+        const result = (await tool.handler({ query: "index", category: "schema" }));
+        expect(result).toBeDefined();
+        if (result.totalResults > 0) {
+            expect(result.gotchas.every((g) => g.category === "schema")).toBe(true);
+        }
+    });
+});
+describe("Cron Tools", () => {
+    it("convex_check_crons validates crons.ts", async () => {
+        const tool = cronTools.find((t) => t.name === "convex_check_crons");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.hasCrons).toBe(true);
+        expect(result.totalCrons).toBeGreaterThan(10);
+        console.log(`Crons: ${result.totalCrons} total (${result.byType.interval} interval, ${result.byType.daily} daily, ${result.byType.weekly} weekly, ${result.byType.monthly} monthly)`);
+        console.log(`Cron issues: ${result.issues.total} (${result.issues.critical} critical, ${result.issues.warnings} warnings)`);
+    });
+});
+describe("Component Tools", () => {
+    it("convex_analyze_components parses convex.config.ts", async () => {
+        const tool = componentTools.find((t) => t.name === "convex_analyze_components");
+        const result = (await tool.handler({ projectDir: PROJECT_DIR }));
+        expect(result).toBeDefined();
+        expect(result.hasConfig).toBe(true);
+        expect(result.totalComponents).toBeGreaterThan(5);
+        expect(result.activeComponents).toBeGreaterThan(0);
+        console.log(`Components: ${result.totalComponents} total, ${result.activeComponents} active, ${result.conditionalComponents} conditional`);
+        console.log(`Component issues: ${result.issues.total}`);
+    });
+});
+describe("Tool Count", () => {
+    it("has exactly 16 tools", () => {
+        const allTools = [
+            ...schemaTools,
+            ...functionTools,
+            ...deploymentTools,
+            ...learningTools,
+            ...methodologyTools,
+            ...integrationBridgeTools,
+            ...cronTools,
+            ...componentTools,
+        ];
+        expect(allTools.length).toBe(16);
+        console.log(`Total tools: ${allTools.length}`);
+        console.log("Tools:", allTools.map((t) => t.name).join(", "));
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/__tests__/tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.js","sourceRoot":"","sources":["../../src/__tests__/tools.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,sBAAsB,EAAE,MAAM,oCAAoC,CAAC;AAC5E,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,+CAA+C;AAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;AAEtD,SAAS,CAAC,GAAG,EAAE;IACb,KAAK,EAAE,CAAC;IACR,kBAAkB,CAAC,cAAqB,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE;IAC5B,EAAE,CAAC,+CAA+C,EAAE,KAAK,IAAI,EAAE;QAC7D,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,qBAAqB,CAAE,CAAC;QACxE,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzD,OAAO,CAAC,GAAG,CAAC,iBAAiB,MAAM,CAAC,OAAO,CAAC,WAAW,YAAY,MAAM,CAAC,OAAO,CAAC,QAAQ,cAAc,MAAM,CAAC,OAAO,CAAC,QAAQ,YAAY,CAAC,CAAC;IAC/I,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QAC3E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACtD,OAAO,CAAC,GAAG,CAAC,sBAAsB,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC/D,CAAC,EAAE,MAAM,CAAC,CAAC;IAEX,EAAE,CAAC,2DAA2D,EAAE,KAAK,IAAI,EAAE;QACzE,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,iCAAiC,CAAE,CAAC;QACpF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,OAAO,CAAC,qBAAqB,UAAU,MAAM,CAAC,OAAO,CAAC,wBAAwB,aAAa,MAAM,CAAC,OAAO,CAAC,cAAc,aAAa,CAAC,CAAC;IACnL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QAC7E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,OAAO,MAAM,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC5D,OAAO,CAAC,GAAG,CAAC,mBAAmB,MAAM,CAAC,OAAO,CAAC,cAAc,eAAe,MAAM,CAAC,OAAO,CAAC,WAAW,YAAY,MAAM,CAAC,OAAO,CAAC,QAAQ,YAAY,CAAC,CAAC;IACxJ,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sDAAsD,EAAE,KAAK,IAAI,EAAE;QACpE,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,4BAA4B,CAAE,CAAC;QACjF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,OAAO,CAAC,eAAe,UAAU,MAAM,CAAC,OAAO,CAAC,sBAAsB,4BAA4B,CAAC,CAAC;IAC3I,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;IAChC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC7C,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,QAAQ,CAAC,MAAM,YAAY,CAAC,CAAC;IAC3I,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iDAAiD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,IAAI,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC9E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3C,OAAO,CAAC,GAAG,CAAC,aAAa,MAAM,CAAC,aAAa,CAAC,MAAM,aAAa,MAAM,CAAC,gBAAgB,CAAC,MAAM,kBAAkB,MAAM,CAAC,gBAAgB,CAAC,MAAM,UAAU,CAAC,CAAC;IAC7J,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,gBAAgB,EAAE,GAAG,EAAE;IAC9B,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QAC1D,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAQ,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,6BAA6B,CAAC,CAAC;QAClE,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,CAAC,YAAY,UAAU,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC,CAAQ,CAAC;QAC3E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,sCAAsC,MAAM,CAAC,YAAY,UAAU,CAAC,CAAC;IACnF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,sBAAsB,CAAE,CAAC;QAC3E,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC;YAClC,GAAG,EAAE,oBAAoB;YACzB,OAAO,EAAE,yBAAyB;YAClC,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,MAAM;YAChB,IAAI,EAAE,aAAa;SACpB,CAAC,CAAQ,CAAC;QACX,MAAM,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAEzD,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC;YAClC,GAAG,EAAE,oBAAoB;YACzB,OAAO,EAAE,iCAAiC;YAC1C,QAAQ,EAAE,SAAS;YACnB,QAAQ,EAAE,MAAM;SACjB,CAAC,CAAQ,CAAC;QACX,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,mBAAmB,EAAE,GAAG,EAAE;IACjC,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QAChF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAQ,CAAC;QAClE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAC3C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QAChF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,CAAC,CAAQ,CAAC;QAC7E,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAQ,CAAC;QACtE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,4BAA4B,MAAM,CAAC,aAAa,cAAc,CAAC,CAAC;IAC9E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,KAAK,IAAI,EAAE;QACzD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC/E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAQ,CAAC;QACxF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjF,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,0BAA0B,EAAE,GAAG,EAAE;IACxC,EAAE,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;QAChE,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,0BAA0B,CAAE,CAAC;QACxF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC,0BAA0B,CAAC,CAAC;QAC7D,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,KAAK,QAAQ,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,wBAAwB,CAAE,CAAC;QACtF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,WAAW,EAAE,CAAC;QACxC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,oBAAoB,MAAM,CAAC,UAAU,SAAS,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;QACtD,MAAM,IAAI,GAAG,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,0BAA0B,CAAE,CAAC;QACxF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7C,OAAO,CAAC,GAAG,CAAC,cAAc,MAAM,CAAC,OAAO,CAAC,IAAI,UAAU,MAAM,CAAC,OAAO,CAAC,QAAQ,cAAc,MAAM,CAAC,OAAO,CAAC,SAAS,YAAY,CAAC,CAAC;IACpI,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,6EAA6E;AAE7E,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,6CAA6C,EAAE,GAAG,EAAE;QACrD,MAAM,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC;IACtD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACzC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,wBAAwB,CAAC,CAAC;QAClD,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IACnD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8BAA8B,EAAE,GAAG,EAAE;QACtC,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;QACpC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC;QACjD,kEAAkE;QAClE,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACpD,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,sBAAsB,CAAC,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,uBAAuB,CAAC,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iEAAiE,EAAE,GAAG,EAAE;QACzE,MAAM,OAAO,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;QACvC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAC1C,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC3D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,qCAAqC,EAAE,GAAG,EAAE;IACnD,EAAE,CAAC,0CAA0C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,CAAC,CAAQ,CAAC;QACrF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,KAAK,IAAI,EAAE;QACvD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,0BAA0B,EAAE,CAAC,CAAQ,CAAC;QAClF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;QACjD,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,uBAAuB,CAAE,CAAC;QAC5E,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAQ,CAAC;QACnF,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/E,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,uCAAuC,EAAE,KAAK,IAAI,EAAE;QACrD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,oBAAoB,CAAE,CAAC;QACrE,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;QAC9C,OAAO,CAAC,GAAG,CAAC,UAAU,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,MAAM,CAAC,KAAK,WAAW,MAAM,CAAC,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC;QACtL,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,CAAC,MAAM,CAAC,KAAK,KAAK,MAAM,CAAC,MAAM,CAAC,QAAQ,cAAc,MAAM,CAAC,MAAM,CAAC,QAAQ,YAAY,CAAC,CAAC;IAC9H,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE;IAC/B,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QACjE,MAAM,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,2BAA2B,CAAE,CAAC;QACjF,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAQ,CAAC;QACxE,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7B,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QAClD,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;QACnD,OAAO,CAAC,GAAG,CAAC,eAAe,MAAM,CAAC,eAAe,WAAW,MAAM,CAAC,gBAAgB,YAAY,MAAM,CAAC,qBAAqB,cAAc,CAAC,CAAC;QAC3I,OAAO,CAAC,GAAG,CAAC,qBAAqB,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,EAAE,CAAC,sBAAsB,EAAE,GAAG,EAAE;QAC9B,MAAM,QAAQ,GAAG;YACf,GAAG,WAAW;YACd,GAAG,aAAa;YAChB,GAAG,eAAe;YAClB,GAAG,aAAa;YAChB,GAAG,gBAAgB;YACnB,GAAG,sBAAsB;YACzB,GAAG,SAAS;YACZ,GAAG,cAAc;SAClB,CAAC;QACF,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,gBAAgB,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChE,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/db.d.ts

@@ -0,0 +1,10 @@
+import Database from "better-sqlite3";
+export declare function getDb(): Database.Database;
+export declare function genId(prefix: string): string;
+export declare function seedGotchasIfEmpty(gotchas: Array<{
+    key: string;
+    content: string;
+    category: string;
+    severity: string;
+    tags: string;
+}>): void;

package/dist/db.js

@@ -0,0 +1,125 @@
+import Database from "better-sqlite3";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { mkdirSync } from "node:fs";
+let _db = null;
+const SCHEMA_SQL = `
+PRAGMA journal_mode = WAL;
+PRAGMA busy_timeout = 5000;
+PRAGMA foreign_keys = ON;
+
+-- ═══════════════════════════════════════════
+-- CONVEX GOTCHAS (Persistent knowledge base)
+-- ═══════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS convex_gotchas (
+  id            INTEGER PRIMARY KEY AUTOINCREMENT,
+  key           TEXT NOT NULL UNIQUE,
+  content       TEXT NOT NULL,
+  category      TEXT NOT NULL DEFAULT 'general',
+  severity      TEXT NOT NULL DEFAULT 'warning',
+  convex_version TEXT,
+  tags          TEXT,
+  source        TEXT NOT NULL DEFAULT 'seed',
+  created_at    TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE VIRTUAL TABLE IF NOT EXISTS convex_gotchas_fts USING fts5(
+  key,
+  content,
+  category,
+  tags,
+  content='convex_gotchas',
+  content_rowid='id'
+);
+
+CREATE TRIGGER IF NOT EXISTS gotchas_fts_insert AFTER INSERT ON convex_gotchas BEGIN
+  INSERT INTO convex_gotchas_fts(rowid, key, content, category, tags)
+  VALUES (new.id, new.key, new.content, new.category, COALESCE(new.tags, ''));
+END;
+
+CREATE TRIGGER IF NOT EXISTS gotchas_fts_delete AFTER DELETE ON convex_gotchas BEGIN
+  INSERT INTO convex_gotchas_fts(convex_gotchas_fts, rowid, key, content, category, tags)
+  VALUES ('delete', old.id, old.key, old.content, old.category, COALESCE(old.tags, ''));
+END;
+
+CREATE TRIGGER IF NOT EXISTS gotchas_fts_update AFTER UPDATE ON convex_gotchas BEGIN
+  INSERT INTO convex_gotchas_fts(convex_gotchas_fts, rowid, key, content, category, tags)
+  VALUES ('delete', old.id, old.key, old.content, old.category, COALESCE(old.tags, ''));
+  INSERT INTO convex_gotchas_fts(rowid, key, content, category, tags)
+  VALUES (new.id, new.key, new.content, new.category, COALESCE(new.tags, ''));
+END;
+
+-- ═══════════════════════════════════════════
+-- SCHEMA SNAPSHOTS (for diff/audit history)
+-- ═══════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS schema_snapshots (
+  id            TEXT PRIMARY KEY,
+  project_dir   TEXT NOT NULL,
+  schema_json   TEXT NOT NULL,
+  function_spec TEXT,
+  snapshot_at   TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_schema_snapshots_project ON schema_snapshots(project_dir);
+
+-- ═══════════════════════════════════════════
+-- DEPLOYMENT CHECKS (audit trail)
+-- ═══════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS deploy_checks (
+  id            TEXT PRIMARY KEY,
+  project_dir   TEXT NOT NULL,
+  check_type    TEXT NOT NULL,
+  passed        INTEGER NOT NULL DEFAULT 0,
+  findings      TEXT,
+  checked_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_deploy_checks_project ON deploy_checks(project_dir);
+
+-- ═══════════════════════════════════════════
+-- AUDIT RESULTS (per-file analysis cache)
+-- ═══════════════════════════════════════════
+
+CREATE TABLE IF NOT EXISTS audit_results (
+  id            TEXT PRIMARY KEY,
+  project_dir   TEXT NOT NULL,
+  audit_type    TEXT NOT NULL,
+  file_path     TEXT,
+  issues_json   TEXT NOT NULL,
+  issue_count   INTEGER NOT NULL DEFAULT 0,
+  audited_at    TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE INDEX IF NOT EXISTS idx_audit_results_project ON audit_results(project_dir);
+CREATE INDEX IF NOT EXISTS idx_audit_results_type ON audit_results(audit_type);
+`;
+export function getDb() {
+    if (_db)
+        return _db;
+    const dir = join(homedir(), ".convex-mcp-nodebench");
+    mkdirSync(dir, { recursive: true });
+    _db = new Database(join(dir, "convex.db"));
+    _db.exec(SCHEMA_SQL);
+    return _db;
+}
+export function genId(prefix) {
+    return `${prefix}_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`;
+}
+export function seedGotchasIfEmpty(gotchas) {
+    const db = getDb();
+    const count = db.prepare("SELECT COUNT(*) as c FROM convex_gotchas").get().c;
+    if (count > 0)
+        return;
+    const insert = db.prepare("INSERT OR IGNORE INTO convex_gotchas (key, content, category, severity, tags, source) VALUES (?, ?, ?, ?, ?, 'seed')");
+    const tx = db.transaction(() => {
+        for (const g of gotchas) {
+            insert.run(g.key, g.content, g.category, g.severity, g.tags);
+        }
+    });
+    tx();
+}
+//# sourceMappingURL=db.js.map

package/dist/db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../src/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAEpC,IAAI,GAAG,GAA6B,IAAI,CAAC;AAEzC,MAAM,UAAU,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6FlB,CAAC;AAEF,MAAM,UAAU,KAAK;IACnB,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACpB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,uBAAuB,CAAC,CAAC;IACrD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACpC,GAAG,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IAC3C,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrB,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,MAAc;IAClC,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,OAAkG;IACnI,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,KAAK,GAAI,EAAE,CAAC,OAAO,CAAC,0CAA0C,CAAC,CAAC,GAAG,EAAU,CAAC,CAAC,CAAC;IACtF,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO;IAEtB,MAAM,MAAM,GAAG,EAAE,CAAC,OAAO,CACvB,sHAAsH,CACvH,CAAC;IACF,MAAM,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAC7B,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC,CAAC,CAAC;IACH,EAAE,EAAE,CAAC;AACP,CAAC"}