midnight-mcp 0.1.16 → 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,12 +157,13 @@ 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;
+    versionWarning?: string | undefined;
+    repository: string;
+    version: string;
     warning?: undefined;
     syntaxFiles?: undefined;
     examplePaths?: undefined;
@@ -172,9 +173,6 @@ export declare function getLatestSyntax(input: GetLatestSyntaxInput): Promise<{
     warning: string;
     syntaxFiles: never[];
     examplePaths: string[];
-    syntaxReference?: undefined;
-    sections?: undefined;
-    pitfalls?: undefined;
     note?: undefined;
 } | {
     repository: string;
@@ -184,9 +182,6 @@ 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

@@ -306,10 +306,36 @@ export async function getLatestSyntax(input) {
     // 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",

package/package.json

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