latitude-mcp-server 4.0.0 → 4.0.1

package/dist/api.d.ts

@@ -43,11 +43,11 @@ export interface ValidationIssue {
 }
 export declare function validatePromptLContent(content: string, path: string): Promise<ValidationIssue[]>;
 /**
- * Deploy changes to LIVE version using SDK-style atomic push.
+ * Deploy changes to LIVE version using draft→push→merge workflow.
  *
- * This matches the CLI's approach:
- * - Single POST to /versions/live/push with all changes
- * - Returns the new committed version UUID
- * - No separate create→push→publish workflow
+ * Workflow:
+ * 1. Create a new draft version
+ * 2. Push all changes to the draft
+ * 3. Merge the draft to live
  */
 export declare function deployToLive(changes: DocumentChange[], _versionName?: string): Promise<DeployResult>;

package/dist/api.js

@@ -414,12 +414,20 @@ async function validatePromptLContent(content, path) {
     return issues;
 }
 /**
- * Push changes to a version atomically.
- * This is the SDK-style push that creates a new version with all changes applied.
- *
- * Endpoint: POST /projects/:projectId/versions/:versionUuid/push
- * Body: { changes: [...] }
- * Returns: { commitUuid: string } - the new version UUID
+ * Create a new draft version based on HEAD (live).
+ */
+async function createDraftVersion(name) {
+    const projectId = getProjectId();
+    const timestamp = Date.now();
+    const versionName = name || `mcp-draft-${timestamp}`;
+    logger.info(`Creating draft version: ${versionName}`);
+    return request(`/projects/${projectId}/versions`, {
+        method: 'POST',
+        body: { name: versionName },
+    });
+}
+/**
+ * Push changes to a draft version.
  */
 async function pushToVersion(versionUuid, changes) {
     const projectId = getProjectId();
@@ -448,12 +456,12 @@ function createNoOpVersion() {
     };
 }
 /**
- * Deploy changes to LIVE version using SDK-style atomic push.
+ * Deploy changes to LIVE version using draft→push→merge workflow.
  *
- * This matches the CLI's approach:
- * - Single POST to /versions/live/push with all changes
- * - Returns the new committed version UUID
- * - No separate create→push→publish workflow
+ * Workflow:
+ * 1. Create a new draft version
+ * 2. Push all changes to the draft
+ * 3. Merge the draft to live
  */
 async function deployToLive(changes, _versionName) {
     if (changes.length === 0) {
@@ -482,20 +490,24 @@ async function deployToLive(changes, _versionName) {
     const deleted = actualChanges.filter((c) => c.status === 'deleted').map((c) => c.path);
     logger.info(`Deploying to LIVE: ${added.length} added, ${modified.length} modified, ${deleted.length} deleted`);
     try {
-        const result = await pushToVersion('live', actualChanges);
-        logger.info(`Push successful! New version: ${result.commitUuid}`);
+        // Step 1: Create a draft version
+        const draft = await createDraftVersion(_versionName);
+        logger.info(`Created draft version: ${draft.uuid}`);
+        // Step 2: Push changes to the draft - this creates a new committed version
+        const pushResult = await pushToVersion(draft.uuid, actualChanges);
+        logger.info(`Pushed changes. New commit: ${pushResult.commitUuid}`);
         const now = new Date().toISOString();
         return {
             version: {
-                id: 0,
-                uuid: result.commitUuid,
+                id: draft.id,
+                uuid: pushResult.commitUuid,
                 projectId: 0,
                 message: _versionName || 'MCP push',
                 createdAt: now,
                 updatedAt: now,
-                status: 'live',
+                status: 'merged',
             },
-            documentsProcessed: result.documentsProcessed || actualChanges.length,
+            documentsProcessed: pushResult.documentsProcessed || actualChanges.length,
             added,
             modified,
             deleted,
@@ -503,7 +515,7 @@ async function deployToLive(changes, _versionName) {
     }
     catch (error) {
         if (error instanceof LatitudeApiError) {
-            logger.error(`Push failed: ${error.message}`);
+            logger.error(`Deploy failed: ${error.message}`);
             throw error;
         }
         throw error;

package/dist/tools.js

@@ -106,13 +106,20 @@ function readPromptsFromFolder(folderPath) {
         throw new Error(`No .promptl files found in: ${resolvedPath}`);
     }
     const prompts = [];
+    const conversions = [];
     for (const file of files) {
         const filePath = (0, path_1.join)(resolvedPath, file);
         const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
-        const name = file.replace(/\.promptl$/, '').replace(/_/g, '/');
+        // Remove .promptl extension, convert . to - for API compatibility (only letters, numbers, '.', '-', '_' allowed)
+        const baseName = file.replace(/\.promptl$/, '');
+        // Replace dots with dashes (API allows dots but it's cleaner as dashes)
+        const name = baseName.replace(/\./g, '-');
+        if (baseName !== name) {
+            conversions.push(`${file} → ${name}`);
+        }
         prompts.push({ name, content });
     }
-    return prompts;
+    return { prompts, conversions };
 }
 // Format available prompts for description
 function formatAvailablePrompts(names) {
@@ -316,7 +323,7 @@ async function handlePushPrompts(args) {
         if (!args.folderPath) {
             return formatError(new Error('folderPath is required. Provide absolute path to folder containing .promptl files.'));
         }
-        const prompts = readPromptsFromFolder(args.folderPath);
+        const { prompts, conversions } = readPromptsFromFolder(args.folderPath);
         logger.info(`Read ${prompts.length} prompt(s) from ${args.folderPath}`);
         // PRE-VALIDATE ALL PROMPTS BEFORE PUSHING
         // If ANY prompt fails validation, return errors and push NOTHING
@@ -355,6 +362,11 @@ async function handlePushPrompts(args) {
             content += `- Modified: ${modified.length}\n`;
             content += `- Deleted: ${deleted.length}\n`;
             content += `- Documents processed: ${result.documentsProcessed}\n\n`;
+            if (conversions.length > 0) {
+                content += `### ⚠️ Auto-converted Names\n`;
+                content += `Dots (.) in filenames were converted to underscores (_) for API compatibility:\n`;
+                content += conversions.map((c) => `- ${c}`).join('\n') + '\n\n';
+            }
             if (added.length > 0) {
                 content += `### Added\n${added.map((c) => `- \`${c.path}\``).join('\n')}\n\n`;
             }
@@ -424,7 +436,7 @@ async function handleAddPrompt(args) {
             const filename = `${prompt.name.replace(/\//g, '_')}.promptl`;
             (0, fs_1.writeFileSync)((0, path_1.join)(tempDir, filename), prompt.content, 'utf-8');
         }
-        const mergedPrompts = readPromptsFromFolder(tempDir);
+        const { prompts: mergedPrompts } = readPromptsFromFolder(tempDir);
         logger.info(`Merged state: ${mergedPrompts.length} total prompt(s)`);
         logger.info(`Validating ${mergedPrompts.length} prompt(s) before push...`);
         const validation = await validateAllPrompts(mergedPrompts);

package/package.json

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