latitude-mcp-server 2.2.1 → 2.2.3

package/dist/api.d.ts

@@ -33,6 +33,7 @@ export declare class LatitudeApiError extends Error {
  */
 export declare function getProjectId(): string;
 export declare function listVersions(): Promise<Version[]>;
+export declare function getVersion(versionUuid: string): Promise<Version>;
 export declare function createVersion(name: string): Promise<Version>;
 export declare function publishVersion(versionUuid: string, title?: string): Promise<Version>;
 export declare function listDocuments(versionUuid?: string): Promise<Document[]>;
@@ -72,6 +73,6 @@ export declare function runDocument(path: string, parameters?: Record<string, un
  *
  * This is the same workflow the CLI uses, ensuring proper validation.
  */
-export declare function deployToLive(changes: DocumentChange[], versionName?: string): Promise<DeployResult>;
+export declare function deployToLive(changes: DocumentChange[], _versionName?: string): Promise<DeployResult>;
 export declare function getPromptNames(): Promise<string[]>;
 export {};

package/dist/api.js

@@ -16,6 +16,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LatitudeApiError = void 0;
 exports.getProjectId = getProjectId;
 exports.listVersions = listVersions;
+exports.getVersion = getVersion;
 exports.createVersion = createVersion;
 exports.publishVersion = publishVersion;
 exports.listDocuments = listDocuments;
@@ -60,6 +61,13 @@ async function request(endpoint, options = {}) {
     const timeoutId = setTimeout(() => controller.abort(), options.timeout || API_TIMEOUT_MS);
     logger.debug(`API ${method} ${endpoint}`);
     try {
+        // Add __internal: { source: 'api' } to all POST requests (required by Latitude API)
+        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: {
@@ -67,7 +75,7 @@ async function request(endpoint, options = {}) {
                 Accept: 'application/json',
                 Authorization: `Bearer ${apiKey}`,
             },
-            body: options.body ? JSON.stringify(options.body) : undefined,
+            body: body ? JSON.stringify(body) : undefined,
             signal: controller.signal,
         });
         clearTimeout(timeoutId);
@@ -264,6 +272,10 @@ async function listVersions() {
     const projectId = getProjectId();
     return request(`/projects/${projectId}/versions`);
 }
+async function getVersion(versionUuid) {
+    const projectId = getProjectId();
+    return request(`/projects/${projectId}/versions/${versionUuid}`);
+}
 async function createVersion(name) {
     const projectId = getProjectId();
     return request(`/projects/${projectId}/versions`, {
@@ -386,27 +398,38 @@ async function runDocument(path, parameters, versionUuid = 'live') {
     });
 }
 /**
- * Format timestamp for version names: "14 Jan 2025 - 13:11"
- * Optionally prepend action prefix like "push cover-letter"
+ * Identify which documents fail validation by testing each one individually.
+ * Used when a batch publish fails to provide actionable error messages.
  */
-function formatVersionName(prefix) {
-    const now = new Date();
-    const options = {
-        timeZone: 'America/Los_Angeles',
-        day: 'numeric',
-        month: 'short',
-        year: 'numeric',
-        hour: '2-digit',
-        minute: '2-digit',
-        hour12: false,
-    };
-    const formatted = now.toLocaleString('en-US', options);
-    // "Jan 14, 2025, 13:11" → "14 Jan 2025 - 13:11"
-    const match = formatted.match(/(\w+)\s+(\d+),\s+(\d+),\s+(\d+:\d+)/);
-    const timestamp = match
-        ? `${match[2]} ${match[1]} ${match[3]} - ${match[4]}`
-        : now.toISOString().replace(/[:.]/g, '-');
-    return prefix ? `${prefix} (${timestamp})` : timestamp;
+async function identifyFailingDocuments(changes) {
+    const failed = [];
+    for (const change of changes) {
+        if (change.status === 'deleted')
+            continue; // Deletes don't have content validation
+        try {
+            // Create a test draft for this single document
+            const testDraft = await createVersion(`validation-test-${change.path}`);
+            // Push just this document
+            await pushChanges(testDraft.uuid, [change]);
+            // Try to publish - this will fail if document has validation errors
+            await publishVersion(testDraft.uuid);
+            // If we get here, document is valid - the draft was published but that's ok
+            logger.debug(`Document ${change.path} validated successfully`);
+        }
+        catch (error) {
+            // This document failed - capture the error
+            const errorMsg = error instanceof LatitudeApiError
+                ? error.message
+                : (error instanceof Error ? error.message : 'Unknown validation error');
+            failed.push({
+                path: change.path,
+                error: errorMsg,
+                content: change.content?.substring(0, 200) + (change.content && change.content.length > 200 ? '...' : ''),
+            });
+            logger.debug(`Document ${change.path} failed validation: ${errorMsg}`);
+        }
+    }
+    return failed;
 }
 /**
  * Create a synthetic Version object for no-op deploys.
@@ -432,7 +455,7 @@ function createNoOpVersion() {
  *
  * This is the same workflow the CLI uses, ensuring proper validation.
  */
-async function deployToLive(changes, versionName) {
+async function deployToLive(changes, _versionName) {
     if (changes.length === 0) {
         logger.info('No changes to deploy');
         return {
@@ -459,27 +482,46 @@ async function deployToLive(changes, versionName) {
     const added = actualChanges.filter((c) => c.status === 'added').map((c) => c.path);
     const modified = actualChanges.filter((c) => c.status === 'modified').map((c) => c.path);
     const deleted = actualChanges.filter((c) => c.status === 'deleted').map((c) => c.path);
-    const name = formatVersionName(versionName);
     logger.info(`Deploying to LIVE: ${added.length} added, ${modified.length} modified, ${deleted.length} deleted`);
     // Step 1: Create a new draft version
-    logger.info(`Creating draft version: ${name}`);
-    const draft = await createVersion(name);
+    const draftName = `MCP deploy ${new Date().toISOString()}`;
+    logger.info(`Creating draft version: ${draftName}`);
+    const draft = await createVersion(draftName);
     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
     logger.info(`Publishing draft ${draft.uuid} to LIVE...`);
-    const published = await publishVersion(draft.uuid, name);
-    logger.info(`Published successfully! Version is now LIVE: ${published.uuid}`);
-    return {
-        version: published,
-        documentsProcessed: pushResult.documentsProcessed,
-        added,
-        modified,
-        deleted,
-    };
+    try {
+        const published = await publishVersion(draft.uuid, draftName);
+        logger.info(`Published successfully! Version is now LIVE: ${published.uuid}`);
+        return {
+            version: published,
+            documentsProcessed: pushResult.documentsProcessed,
+            added,
+            modified,
+            deleted,
+        };
+    }
+    catch (publishError) {
+        // Publish failed - identify which document(s) have validation errors
+        logger.warn('Batch publish failed, identifying problematic documents...');
+        const failedDocs = await identifyFailingDocuments(actualChanges);
+        if (failedDocs.length > 0) {
+            const errorDetails = failedDocs.map(f => `- ${f.path}: ${f.error}`).join('\n');
+            throw new LatitudeApiError({
+                name: 'DocumentValidationError',
+                errorCode: 'DOCUMENT_VALIDATION_FAILED',
+                message: `${failedDocs.length} document(s) failed validation:\n${errorDetails}`,
+                details: { failedDocuments: failedDocs },
+            }, 422);
+        }
+        // Re-throw original error if we couldn't identify specific failures
+        throw publishError;
+    }
 }
 async function getPromptNames() {
     try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "latitude-mcp-server",
-	"version": "2.2.1",
+	"version": "2.2.3",
 	"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",