latitude-mcp-server 2.2.6 → 3.0.0

package/dist/api.d.ts

@@ -52,10 +52,6 @@ interface PushResponse {
  * This is the CLI-style push that sends all changes at once
  */
 export declare function pushChanges(versionUuid: string, changes: DocumentChange[]): Promise<PushResponse>;
-/**
- * Compute hash of content for diff comparison
- */
-export declare function hashContent(content: string): string;
 /**
  * Compute diff between incoming prompts and existing prompts
  * Returns only the changes that need to be made
@@ -65,6 +61,24 @@ export declare function computeDiff(incoming: Array<{
     content: string;
 }>, existing: Document[]): DocumentChange[];
 export declare function runDocument(path: string, parameters?: Record<string, unknown>, versionUuid?: string): Promise<RunResult>;
+export interface ValidationIssue {
+    type: 'error' | 'warning';
+    code: string;
+    message: string;
+    rootCause: string;
+    suggestion: string;
+    location?: {
+        line: number;
+        column: number;
+    };
+    codeFrame?: string;
+}
+/**
+ * Pre-validate PromptL content using the official promptl-ai library.
+ * Returns detailed, actionable error messages with code frames.
+ * EXPORTED for use by tools.ts to pre-validate before pushing.
+ */
+export declare function validatePromptLContent(content: string, path: string): Promise<ValidationIssue[]>;
 /**
  * Deploy changes to LIVE version using the proper workflow:
  * 1. Create a draft version

package/dist/api.js

@@ -24,9 +24,9 @@ exports.getDocument = getDocument;
 exports.createOrUpdateDocument = createOrUpdateDocument;
 exports.deleteDocument = deleteDocument;
 exports.pushChanges = pushChanges;
-exports.hashContent = hashContent;
 exports.computeDiff = computeDiff;
 exports.runDocument = runDocument;
+exports.validatePromptLContent = validatePromptLContent;
 exports.deployToLive = deployToLive;
 exports.getPromptNames = getPromptNames;
 const logger_util_js_1 = require("./utils/logger.util.js");
@@ -66,9 +66,6 @@ async function request(endpoint, options = {}) {
         const body = options.body && method === 'POST'
             ? { ...options.body, __internal: { source: 'api' } }
             : options.body;
-        if (body) {
-            logger.debug(`Request body: ${JSON.stringify(body, null, 2)}`);
-        }
         const response = await fetch(url, {
             method,
             headers: {
@@ -332,19 +329,6 @@ async function pushChanges(versionUuid, changes) {
         body: { changes: apiChanges },
     });
 }
-/**
- * Compute hash of content for diff comparison
- */
-function hashContent(content) {
-    // Simple hash - in production you might want crypto
-    let hash = 0;
-    for (let i = 0; i < content.length; i++) {
-        const char = content.charCodeAt(i);
-        hash = ((hash << 5) - hash) + char;
-        hash = hash & hash; // Convert to 32bit integer
-    }
-    return hash.toString(16);
-}
 /**
  * Compute diff between incoming prompts and existing prompts
  * Returns only the changes that need to be made
@@ -446,6 +430,7 @@ const ERROR_SUGGESTIONS = {
 /**
  * Pre-validate PromptL content using the official promptl-ai library.
  * Returns detailed, actionable error messages with code frames.
+ * EXPORTED for use by tools.ts to pre-validate before pushing.
  */
 async function validatePromptLContent(content, path) {
     const issues = [];
@@ -704,7 +689,6 @@ async function deployToLive(changes, _versionName) {
     logger.info(`Draft created: ${draft.uuid}`);
     // Step 2: Push all changes to the draft in ONE batch
     logger.info(`Pushing ${actualChanges.length} change(s) to draft...`);
-    logger.debug(`Changes payload: ${JSON.stringify(actualChanges, null, 2)}`);
     const pushResult = await pushChanges(draft.uuid, actualChanges);
     logger.info(`Push complete: ${pushResult.documentsProcessed} documents processed`);
     // Step 3: Publish the draft to make it LIVE

package/dist/tools.js

@@ -106,6 +106,55 @@ function formatAvailablePrompts(names) {
     const formatted = names.map(n => `\`${n}\``).join(', ');
     return `\n\n**Available prompts (${names.length}):** ${formatted}`;
 }
+/**
+ * Validate all prompts BEFORE pushing.
+ * If ANY prompt fails validation, returns all errors and NOTHING is pushed.
+ */
+async function validateAllPrompts(prompts) {
+    const errors = [];
+    for (const prompt of prompts) {
+        const issues = await (0, api_js_1.validatePromptLContent)(prompt.content, prompt.name);
+        const errorIssues = issues.filter(i => i.type === 'error');
+        if (errorIssues.length > 0) {
+            errors.push({ name: prompt.name, issues: errorIssues });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+    };
+}
+/**
+ * Format validation errors into a detailed MCP-friendly error message.
+ */
+function formatValidationErrors(errors) {
+    const lines = [
+        `## ❌ Validation Failed - No Changes Made\n`,
+        `**${errors.length} prompt(s) have errors.** Fix all errors before pushing.\n`,
+    ];
+    for (const { name, issues } of errors) {
+        for (const issue of issues) {
+            lines.push(`### ${name}`);
+            lines.push(`**Error Code:** \`${issue.code}\``);
+            lines.push(`**Error:** ${issue.message}`);
+            lines.push(`**Root Cause:** ${issue.rootCause}`);
+            if (issue.location) {
+                lines.push(`**Location:** Line ${issue.location.line}, Column ${issue.location.column}`);
+            }
+            if (issue.codeFrame) {
+                lines.push(`**Code Context:**\n\`\`\`\n${issue.codeFrame}\n\`\`\``);
+            }
+            lines.push(`**Fix:** ${issue.suggestion}`);
+            lines.push('');
+        }
+    }
+    lines.push(`---`);
+    lines.push(`**Action Required:** Fix the errors above, then retry.`);
+    return {
+        content: [{ type: 'text', text: lines.join('\n') }],
+        isError: true,
+    };
+}
 // ============================================================================
 // Tool Handlers
 // ============================================================================
@@ -194,6 +243,15 @@ async function handlePushPrompts(args) {
         if (prompts.length === 0) {
             return formatError(new Error('No prompts provided. Use either prompts array or filePaths.'));
         }
+        // PRE-VALIDATE ALL PROMPTS BEFORE PUSHING
+        // If ANY prompt fails validation, return errors and push NOTHING
+        logger.info(`Validating ${prompts.length} prompt(s) before push...`);
+        const validation = await validateAllPrompts(prompts);
+        if (!validation.valid) {
+            logger.warn(`Validation failed for ${validation.errors.length} prompt(s)`);
+            return formatValidationErrors(validation.errors);
+        }
+        logger.info(`All ${prompts.length} prompt(s) passed validation`);
         // Get existing prompts for diff computation
         const existingDocs = await (0, api_js_1.listDocuments)('live');
         // Compute diff - this determines what needs to be added, modified, or deleted
@@ -279,6 +337,15 @@ async function handleAppendPrompts(args) {
         if (prompts.length === 0) {
             return formatError(new Error('No prompts provided. Use either prompts array or filePaths.'));
         }
+        // PRE-VALIDATE ALL PROMPTS BEFORE APPENDING
+        // If ANY prompt fails validation, return errors and append NOTHING
+        logger.info(`Validating ${prompts.length} prompt(s) before append...`);
+        const validation = await validateAllPrompts(prompts);
+        if (!validation.valid) {
+            logger.warn(`Validation failed for ${validation.errors.length} prompt(s)`);
+            return formatValidationErrors(validation.errors);
+        }
+        logger.info(`All ${prompts.length} prompt(s) passed validation`);
         // Get existing prompts
         const existingDocs = await (0, api_js_1.listDocuments)('live');
         const existingMap = new Map(existingDocs.map((d) => [d.path, d]));
@@ -454,6 +521,15 @@ async function handleReplacePrompt(args) {
         if (!content) {
             return formatError(new Error('Prompt content is required. Provide either `content` or `filePath`.'));
         }
+        // PRE-VALIDATE PROMPT BEFORE REPLACING
+        // If validation fails, return error and replace NOTHING
+        logger.info(`Validating prompt "${name}" before replace...`);
+        const validation = await validateAllPrompts([{ name, content }]);
+        if (!validation.valid) {
+            logger.warn(`Validation failed for prompt "${name}"`);
+            return formatValidationErrors(validation.errors);
+        }
+        logger.info(`Prompt "${name}" passed validation`);
         // Check if prompt exists
         const existingDocs = await (0, api_js_1.listDocuments)('live');
         const exists = existingDocs.some((d) => d.path === name);

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "latitude-mcp-server",
-	"version": "2.2.6",
+	"version": "3.0.0",
 	"description": "Simplified MCP server for Latitude.so prompt management - 8 focused tools for push, pull, run, and manage prompts",
 	"main": "dist/index.js",
 	"types": "dist/index.d.ts",