midnight-mcp 0.1.15 → 0.1.16

package/dist/tools/repository/handlers.d.ts

@@ -157,11 +157,24 @@ export declare function compareSyntax(input: CompareSyntaxInput): Promise<{
  * This is the source of truth for writing valid, compilable contracts
  */
 export declare function getLatestSyntax(input: GetLatestSyntaxInput): Promise<{
+    repository: string;
+    version: string;
+    syntaxReference: string;
+    sections: string[];
+    pitfalls: string[];
+    note: string;
+    warning?: undefined;
+    syntaxFiles?: undefined;
+    examplePaths?: undefined;
+} | {
     repository: string;
     version: string;
     warning: string;
     syntaxFiles: never[];
     examplePaths: string[];
+    syntaxReference?: undefined;
+    sections?: undefined;
+    pitfalls?: undefined;
     note?: undefined;
 } | {
     repository: string;
@@ -171,6 +184,9 @@ export declare function getLatestSyntax(input: GetLatestSyntaxInput): Promise<{
         content: string;
     }[];
     note: string;
+    syntaxReference?: undefined;
+    sections?: undefined;
+    pitfalls?: undefined;
     warning?: undefined;
     examplePaths?: undefined;
 }>;

package/dist/tools/repository/handlers.js

@@ -6,6 +6,7 @@ import { githubClient } from "../../pipeline/index.js";
 import { releaseTracker } from "../../pipeline/releases.js";
 import { logger, DEFAULT_REPOSITORIES, SelfCorrectionHints, } from "../../utils/index.js";
 import { REPO_ALIASES, EXAMPLES } from "./constants.js";
+import { EMBEDDED_DOCS } from "../../resources/content/docs-content.js";
 /**
  * Resolve repository name alias to owner/repo
  */
@@ -301,6 +302,36 @@ export async function getLatestSyntax(input) {
     // Ensure repo defaults to compact if undefined/empty
     const repoName = input?.repo || "compact";
     logger.debug("Getting latest syntax reference", { repo: repoName });
+    // For Compact language, always return our curated reference first
+    // This is more reliable than fetching from GitHub and includes pitfalls/patterns
+    if (repoName === "compact" || repoName === "midnight-compact") {
+        const compactReference = EMBEDDED_DOCS["midnight://docs/compact-reference"];
+        if (compactReference) {
+            return {
+                repository: "midnightntwrk/compact",
+                version: "0.16+ (current)",
+                syntaxReference: compactReference,
+                sections: [
+                    "Basic Structure",
+                    "Data Types",
+                    "Circuits",
+                    "Witnesses",
+                    "State Management",
+                    "Common Patterns",
+                    "Disclosure in Conditionals (IMPORTANT)",
+                    "Common Pitfalls & Solutions",
+                ],
+                pitfalls: [
+                    "Cell<T> wrapper deprecated in 0.15+ - use direct type",
+                    'Cannot assign string literals to Opaque<"string"> - use enum or parameters',
+                    "Must disclose() comparisons used in if/else conditions",
+                    "Counter uses .increment()/.value(), Field uses direct assignment",
+                    "Boolean returns from witnesses need disclose()",
+                ],
+                note: "This is the curated syntax reference for Compact 0.16+. Includes common pitfalls and correct patterns.",
+            };
+        }
+    }
     const resolved = resolveRepo(repoName);
     if (!resolved) {
         throw new Error(`Unknown repository: ${repoName}. Available: ${Object.keys(REPO_ALIASES).join(", ")}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "midnight-mcp",
-  "version": "0.1.15",
+  "version": "0.1.16",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",