suparank 1.3.3 → 1.3.4

package/mcp-client/handlers/orchestrator.js

@@ -205,7 +205,16 @@ async function handleSaveContent(args) {
   const wordCountOk = targetWordCount ? wordCount >= targetWordCount * 0.95 : true
   const shortfall = targetWordCount ? targetWordCount - wordCount : 0
 
+  // Multi-article progress tracking
+  const totalExpected = workflow?.settings?.article_count || 1
+  const savedCount = sessionState.articles.length
+  const remaining = totalExpected - savedCount
+  const isMultiArticle = totalExpected > 1
+
   log(`Word count check: ${wordCount} words (target: ${targetWordCount}, ok: ${wordCountOk})`)
+  if (isMultiArticle) {
+    log(`Multi-article progress: ${savedCount}/${totalExpected} saved, ${remaining} remaining`)
+  }
 
   // Find next step info
   const imageStep = workflow?.steps?.find(s => s.action === 'generate_images')
@@ -261,13 +270,28 @@ Please EXPAND the content before publishing.
 ` : ''}
 ${!meta_description ? '**Warning:** Meta description is missing. Add it for better SEO.\n' : ''}
 ${articlesListSection}${categoriesSection}
-## Next Step${includeImages && imageStep ? ': Generate Images' : ': Ready to Publish or Continue'}
+${isMultiArticle && remaining > 0 ? `## ⚠️ MULTI-ARTICLE WORKFLOW: ${remaining} Article(s) Remaining
+
+**Progress:** ${savedCount} of ${totalExpected} articles saved.
+
+**NEXT ACTION REQUIRED:**
+1. Create article ${savedCount + 1} of ${totalExpected} using topic from content calendar
+2. Call \`content_write\` or write the article directly
+3. Call \`save_content\` to save it
+
+⛔ Do NOT publish until all ${totalExpected} articles are saved!
+` : ''}${isMultiArticle && remaining <= 0 ? `## ✅ ALL ${totalExpected} ARTICLES SAVED!
+
+All articles in your batch are complete. Ready to publish.
+
+**Next:** Call \`publish_content\` to publish all ${savedCount} articles.
+` : ''}${!isMultiArticle ? `## Next Step${includeImages && imageStep ? ': Generate Images' : ': Ready to Publish or Continue'}
 ${includeImages && imageStep ? `Generate **${totalImages} images** (1 cover + ${totalImages - 1} inline images).
 
 Call \`generate_image\` ${totalImages} times with prompts based on your article sections.` : `You can:
 - **Add more articles**: Continue creating content (each save_content adds to the batch)
 - **Publish all**: Call \`publish_content\` to publish all ${sessionState.articles.length} article(s)
-- **View session**: Call \`get_session\` to see all saved articles`}`
+- **View session**: Call \`get_session\` to see all saved articles`}` : ''}`
     }]
   }
 }
@@ -465,6 +489,11 @@ function handleGetSession() {
     return sum + (a.imageUrl ? 1 : 0) + (a.inlineImages?.length || 0)
   }, 0)
 
+  // Multi-article workflow progress
+  const expectedArticles = workflow?.settings?.article_count || 1
+  const isMultiArticle = expectedArticles > 1
+  const remainingArticles = expectedArticles - totalArticles
+
   const articlesSection = sessionState.articles.length > 0 ? `
 ## Saved Articles (${totalArticles} total)
 
@@ -494,16 +523,27 @@ No articles saved yet. Use \`save_content\` after writing an article.
 *This article is being edited. Call \`save_content\` to add it to the session.*
 ` : ''
 
+  // Multi-article progress section
+  const multiArticleProgress = isMultiArticle ? `
+## 📊 Multi-Article Workflow Progress
+**Status:** ${totalArticles}/${expectedArticles} articles saved${remainingArticles > 0 ? ` (${remainingArticles} remaining)` : ' ✅ Complete!'}
+${remainingArticles > 0 ? `
+⚠️ **NEXT:** Create article ${totalArticles + 1} of ${expectedArticles} and save it.
+⛔ Do NOT publish until all ${expectedArticles} articles are saved.
+` : `
+✅ All articles saved! Ready to call \`publish_content\`.
+`}` : ''
+
   return {
     content: [{
       type: 'text',
       text: `# Session State
 
 **Workflow:** ${workflow?.workflow_id || 'None active'}
-**Total Articles:** ${totalArticles}
+**Total Articles:** ${totalArticles}${isMultiArticle ? ` / ${expectedArticles} expected` : ''}
 **Ready to Publish:** ${unpublishedArticles.length}
 **Already Published:** ${publishedArticles.length}
-${articlesSection}${currentWorkingSection}
+${multiArticleProgress}${articlesSection}${currentWorkingSection}
 ## Current Working Images (${imagesGenerated}/${totalImagesNeeded})
 **Cover Image:** ${sessionState.imageUrl || 'Not generated'}
 **Inline Images:** ${sessionState.inlineImages.length > 0 ? sessionState.inlineImages.map((url, i) => `\n  ${i+1}. ${url.substring(0, 60)}...`).join('') : 'None'}

package/mcp-client/tools/definitions.js

@@ -428,13 +428,22 @@ TRIGGERS - Use when user says:
 - "make content about..."
 - any request involving writing/creating/generating articles or blog posts
 
+SINGLE ARTICLE (count=1): Creates, saves, and publishes 1 article automatically.
+
+MULTIPLE ARTICLES (count>1): Creates a workflow with N separate article steps.
+- Each article MUST be written and saved with save_content
+- Progress tracked: "Article 1 of 5", "Article 2 of 5", etc.
+- get_session shows "3/5 articles saved"
+- Do NOT publish until ALL articles are saved
+- After all saved, call publish_content to publish batch
+
 WORKFLOW (automatic 4-phase):
-1. RESEARCH: Keywords, SEO strategy, content structure
-2. CREATION: Outline, write full article, save to session
-3. OPTIMIZATION: Quality check, GEO optimization for AI search
-4. PUBLISHING: Generate images, publish to WordPress/Ghost
+1. RESEARCH: Keywords, SEO strategy, content calendar
+2. CREATION: (write + save) × N articles
+3. OPTIMIZATION: Quality check, GEO optimization
+4. PUBLISHING: Generate images, publish all to CMS
 
-OUTCOME: Complete article written, optimized, and published to CMS.`,
+OUTCOME: Complete article(s) written, optimized, and published to CMS.`,
     inputSchema: {
       type: 'object',
       properties: {

package/mcp-client/workflow/planner.js

@@ -291,14 +291,20 @@ Use format: [IMAGE: description of what image should show]` : '**Note:** Images
     store: 'outline'
   })
 
-  // Step: Write Content
-  stepNum++
-  steps.push({
-    step: stepNum,
-    type: 'llm_execute',
-    action: 'content_write',
-    instruction: `Write the COMPLETE article following your outline.
+  // Step: Write Content (generates N steps for N articles)
+  for (let articleIndex = 0; articleIndex < count; articleIndex++) {
+    const articleNum = articleIndex + 1
+    const isFirstArticle = articleIndex === 0
+    const isLastArticle = articleIndex === count - 1
 
+    stepNum++
+    steps.push({
+      step: stepNum,
+      type: 'llm_execute',
+      action: 'content_write',
+      instruction: `${count > 1 ? `## 📝 ARTICLE ${articleNum} OF ${count}\n\n` : ''}Write the COMPLETE article following your outline.
+${count > 1 && !isFirstArticle ? `\n**Progress:** ${articleIndex} article(s) already saved. Now creating article ${articleNum}.` : ''}
+${count > 1 ? `**Topic:** Use topic #${articleNum} from your content calendar.\n` : ''}
 **MANDATORY WORD COUNT: ${targetWordCount} WORDS MINIMUM**
 This is a strict requirement from the project settings.
 The article will be REJECTED if under ${targetWordCount} words.
@@ -323,16 +329,19 @@ ${shouldGenerateImages ? '- Image placeholders: [IMAGE: description] where image
 - FAQ section with 5-8 Q&As (detailed answers, not one-liners)
 - Strong conclusion with clear CTA
 
-**After writing ${targetWordCount}+ words, call 'save_content' with:**
+**MANDATORY: After writing ${targetWordCount}+ words, call 'save_content' with:**
 - title: Your SEO-optimized title
 - content: The full article (markdown)
 - keywords: Array of target keywords
 - meta_description: Your 150-160 char meta description
 
 STOP! Before calling save_content, verify you have ${targetWordCount}+ words.
-Count the words. If under ${targetWordCount}, ADD MORE CONTENT.`,
-    store: 'article'
-  })
+Count the words. If under ${targetWordCount}, ADD MORE CONTENT.
+${count > 1 && !isLastArticle ? `\n⚠️ After saving this article, you MUST continue with article ${articleNum + 1} of ${count}. Do NOT publish until all ${count} articles are saved.` : ''}
+${count > 1 && isLastArticle ? `\n✅ This is the LAST article (${articleNum} of ${count}). After saving, all articles will be ready for publishing.` : ''}`,
+      store: `article${count > 1 ? `_${articleNum}` : ''}`
+    })
+  }
 
   // ═══════════════════════════════════════════════════════════
   // OPTIMIZATION PHASE
@@ -490,6 +499,7 @@ Call 'publish_content' tool - it will automatically use:
       niche: niche
     },
     settings: {
+      article_count: count,  // Track expected article count for progress
       target_word_count: targetWordCount,
       reading_level: readingLevel,
       reading_level_display: readingLevelDisplay,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "suparank",
-  "version": "1.3.3",
+  "version": "1.3.4",
   "description": "AI-powered SEO content creation MCP - generate and publish optimized blog posts with your AI assistant",
   "type": "module",
   "bin": {