midnight-mcp 0.1.15 → 0.1.17

package/dist/db/vectorStore.d.ts

@@ -11,6 +11,9 @@ export interface CodeDocument {
         codeType: string;
         codeName: string;
         isPublic: boolean;
+        repoVersion?: string;
+        pragmaVersion?: string;
+        indexedAt?: string;
     };
 }
 export interface SearchResult {

package/dist/pipeline/indexer.d.ts

@@ -16,6 +16,9 @@ export interface ChunkMetadata {
     startLine: number;
     endLine: number;
     isPublic: boolean;
+    repoVersion?: string;
+    pragmaVersion?: string;
+    indexedAt?: string;
 }
 /**
  * Index a single repository

package/dist/pipeline/indexer.js

@@ -3,12 +3,26 @@ import { parseFile } from "./parser.js";
 import { embeddingGenerator } from "./embeddings.js";
 import { vectorStore } from "../db/vectorStore.js";
 import { logger, DEFAULT_REPOSITORIES, } from "../utils/index.js";
+/**
+ * Extract pragma language_version from Compact file content
+ * Returns the version string or undefined if not found
+ */
+function extractPragmaVersion(content) {
+    // Match patterns like: pragma language_version >= 0.14.0;
+    const pragmaMatch = content.match(/pragma\s+language_version\s*[><=]*\s*([\d.]+)/);
+    return pragmaMatch?.[1];
+}
 /**
  * Create chunks from a parsed file
  * Uses intelligent chunking based on code structure
  */
-function createChunks(file, repository) {
+function createChunks(file, repository, repoVersion) {
     const chunks = [];
+    const indexedAt = new Date().toISOString();
+    // Extract pragma version for Compact files
+    const pragmaVersion = file.language === "compact"
+        ? extractPragmaVersion(file.content)
+        : undefined;
     // Add code units as individual chunks
     for (const unit of file.codeUnits) {
         chunks.push({
@@ -23,6 +37,9 @@ function createChunks(file, repository) {
                 startLine: unit.startLine,
                 endLine: unit.endLine,
                 isPublic: unit.isPublic,
+                repoVersion,
+                pragmaVersion,
+                indexedAt,
             },
         });
     }
@@ -47,6 +64,9 @@ function createChunks(file, repository) {
                         startLine,
                         endLine: currentLine - 1,
                         isPublic: true,
+                        repoVersion,
+                        pragmaVersion,
+                        indexedAt,
                     },
                 });
                 // Start new chunk with overlap
@@ -69,6 +89,9 @@ function createChunks(file, repository) {
                     startLine,
                     endLine: currentLine - 1,
                     isPublic: true,
+                    repoVersion,
+                    pragmaVersion,
+                    indexedAt,
                 },
             });
         }
@@ -81,6 +104,8 @@ function createChunks(file, repository) {
 export async function indexRepository(repoConfig) {
     const repoName = `${repoConfig.owner}/${repoConfig.repo}`;
     logger.info(`Starting index for ${repoName}...`);
+    // Get repo version (branch name or tag)
+    const repoVersion = repoConfig.branch || "main";
     try {
         // Fetch all files from the repository
         const files = await githubClient.fetchRepositoryFiles(repoConfig);
@@ -90,8 +115,8 @@ export async function indexRepository(repoConfig) {
         for (const file of files) {
             // Parse the file
             const parsed = parseFile(file.path, file.content);
-            // Create chunks
-            const chunks = createChunks(parsed, repoName);
+            // Create chunks with version info
+            const chunks = createChunks(parsed, repoName, repoVersion);
             for (const chunk of chunks) {
                 documents.push({
                     id: `${repoName}:${file.path}:${chunk.metadata.startLine}`,
@@ -105,6 +130,9 @@ export async function indexRepository(repoConfig) {
                         codeType: chunk.metadata.codeUnitType || "unknown",
                         codeName: chunk.metadata.codeUnitName || "",
                         isPublic: chunk.metadata.isPublic,
+                        repoVersion: chunk.metadata.repoVersion,
+                        pragmaVersion: chunk.metadata.pragmaVersion,
+                        indexedAt: chunk.metadata.indexedAt,
                     },
                 });
                 chunkCount++;
@@ -181,7 +209,8 @@ export async function incrementalUpdate(repoConfig, since) {
             const file = await githubClient.getFileContent(repoConfig.owner, repoConfig.repo, filePath, repoConfig.branch);
             if (file) {
                 const parsed = parseFile(file.path, file.content);
-                const chunks = createChunks(parsed, repoName);
+                const repoVersion = repoConfig.branch || "main";
+                const chunks = createChunks(parsed, repoName, repoVersion);
                 for (const chunk of chunks) {
                     documents.push({
                         id: `${repoName}:${filePath}:${chunk.metadata.startLine}`,
@@ -195,6 +224,9 @@ export async function incrementalUpdate(repoConfig, since) {
                             codeType: chunk.metadata.codeUnitType || "unknown",
                             codeName: chunk.metadata.codeUnitName || "",
                             isPublic: chunk.metadata.isPublic,
+                            repoVersion: chunk.metadata.repoVersion,
+                            pragmaVersion: chunk.metadata.pragmaVersion,
+                            indexedAt: chunk.metadata.indexedAt,
                         },
                     });
                     chunkCount++;

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

@@ -157,6 +157,17 @@ 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<{
+    syntaxReference: string;
+    sections: string[];
+    pitfalls: string[];
+    note: string;
+    versionWarning?: string | undefined;
+    repository: string;
+    version: string;
+    warning?: undefined;
+    syntaxFiles?: undefined;
+    examplePaths?: undefined;
+} | {
     repository: string;
     version: string;
     warning: string;

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,62 @@ 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"];
+        // Check if there's a newer release we might not have documented
+        const EMBEDDED_DOCS_VERSION = "0.16"; // Version our docs are based on
+        let versionWarning;
+        try {
+            const versionInfo = await releaseTracker.getVersionInfo("midnightntwrk", "compact");
+            const latestTag = versionInfo.latestStableRelease?.tag || versionInfo.latestRelease?.tag;
+            if (latestTag) {
+                // Extract version number from tag (e.g., "v0.18.0" -> "0.18")
+                const latestVersion = latestTag
+                    .replace(/^v/, "")
+                    .split(".")
+                    .slice(0, 2)
+                    .join(".");
+                const embeddedMajorMinor = EMBEDDED_DOCS_VERSION.split(".")
+                    .slice(0, 2)
+                    .join(".");
+                if (latestVersion !== embeddedMajorMinor &&
+                    parseFloat(latestVersion) > parseFloat(embeddedMajorMinor)) {
+                    versionWarning = `⚠️ Compact ${latestTag} is available. This reference is based on ${EMBEDDED_DOCS_VERSION}. Some syntax may have changed - check release notes for breaking changes.`;
+                }
+            }
+        }
+        catch {
+            // Ignore version check errors, still return cached docs
+        }
+        if (compactReference) {
+            return {
+                repository: "midnightntwrk/compact",
+                version: "0.16+ (current)",
+                ...(versionWarning && { versionWarning }),
+                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.17",
   "description": "Model Context Protocol Server for Midnight Blockchain Development",
   "type": "module",
   "main": "dist/index.js",