suparank 1.3.2 → 1.3.4

package/bin/suparank.js

@@ -15,9 +15,74 @@ import * as fs from 'fs'
 import * as path from 'path'
 import * as os from 'os'
 import * as readline from 'readline'
-import { spawn } from 'child_process'
+import { spawn, execSync } from 'child_process'
+import { fileURLToPath } from 'url'
 
 const SUPARANK_DIR = path.join(os.homedir(), '.suparank')
+const VERSION_CACHE_FILE = path.join(SUPARANK_DIR, '.version-check')
+
+// Get current package version
+function getCurrentVersion() {
+  try {
+    const packagePath = path.join(import.meta.dirname, '..', 'package.json')
+    const pkg = JSON.parse(fs.readFileSync(packagePath, 'utf-8'))
+    return pkg.version
+  } catch {
+    return null
+  }
+}
+
+// Check for updates (non-blocking, cached for 1 hour)
+async function checkForUpdates() {
+  const currentVersion = getCurrentVersion()
+  if (!currentVersion) return
+
+  // Check cache to avoid spamming npm registry
+  try {
+    if (fs.existsSync(VERSION_CACHE_FILE)) {
+      const cache = JSON.parse(fs.readFileSync(VERSION_CACHE_FILE, 'utf-8'))
+      const cacheAge = Date.now() - cache.timestamp
+      if (cacheAge < 3600000) { // 1 hour cache
+        if (cache.latest !== currentVersion && cache.latest > currentVersion) {
+          console.error(`[suparank] Update available: ${currentVersion} → ${cache.latest}`)
+        }
+        return
+      }
+    }
+  } catch {}
+
+  // Fetch latest version from npm (with timeout)
+  try {
+    const controller = new AbortController()
+    const timeout = setTimeout(() => controller.abort(), 3000) // 3 second timeout
+
+    const response = await fetch('https://registry.npmjs.org/suparank/latest', {
+      signal: controller.signal
+    })
+    clearTimeout(timeout)
+
+    if (response.ok) {
+      const data = await response.json()
+      const latestVersion = data.version
+
+      // Cache the result
+      fs.mkdirSync(SUPARANK_DIR, { recursive: true })
+      fs.writeFileSync(VERSION_CACHE_FILE, JSON.stringify({
+        latest: latestVersion,
+        current: currentVersion,
+        timestamp: Date.now()
+      }))
+
+      if (latestVersion !== currentVersion && latestVersion > currentVersion) {
+        console.error(`[suparank] Update available: ${currentVersion} → ${latestVersion}`)
+        console.error('[suparank] Run: npx suparank@latest OR npx clear-npx-cache')
+      }
+    }
+  } catch {
+    // Silently fail - don't block MCP startup
+  }
+}
+
 const CONFIG_FILE = path.join(SUPARANK_DIR, 'config.json')
 const CREDENTIALS_FILE = path.join(SUPARANK_DIR, 'credentials.json')
 const SESSION_FILE = path.join(SUPARANK_DIR, 'session.json')
@@ -35,7 +100,7 @@ const colors = {
 }
 
 // Check if running in MCP mode (no command argument = MCP server)
-const isMCPMode = !process.argv[2] || !['setup', 'test', 'session', 'clear', 'help', '--help', '-h'].includes(process.argv[2])
+const isMCPMode = !process.argv[2] || !['setup', 'test', 'session', 'clear', 'update', 'version', '-v', '--version', 'help', '--help', '-h'].includes(process.argv[2])
 
 function log(message, color = 'reset') {
   // In MCP mode, use stderr to avoid breaking JSON protocol
@@ -344,7 +409,10 @@ function clearSession() {
   }
 }
 
-function runMCP() {
+async function runMCP() {
+  // Check for updates in background (non-blocking)
+  checkForUpdates()
+
   const config = loadConfig()
 
   if (!config) {
@@ -412,6 +480,27 @@ switch (command) {
   case 'clear':
     clearSession()
     break
+  case 'update':
+    logHeader('Updating Suparank')
+    log('Clearing npx cache and fetching latest version...', 'yellow')
+    try {
+      execSync('rm -rf ~/.npm/_npx', { stdio: 'inherit' })
+      log('Cache cleared!', 'green')
+      log('Next run will use the latest version.', 'dim')
+      // Also clear version cache
+      if (fs.existsSync(VERSION_CACHE_FILE)) {
+        fs.unlinkSync(VERSION_CACHE_FILE)
+      }
+    } catch (e) {
+      log(`Update failed: ${e.message}`, 'red')
+    }
+    break
+  case 'version':
+  case '-v':
+  case '--version':
+    const ver = getCurrentVersion()
+    console.log(ver || 'unknown')
+    break
   case 'help':
   case '--help':
   case '-h':
@@ -424,6 +513,8 @@ switch (command) {
     log('  test       Test API connection', 'dim')
     log('  session    View current session state', 'dim')
     log('  clear      Clear session state', 'dim')
+    log('  update     Clear cache and update to latest', 'dim')
+    log('  version    Show current version', 'dim')
     log('  help       Show this help message', 'dim')
     break
   default:

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.2",
+  "version": "1.3.4",
   "description": "AI-powered SEO content creation MCP - generate and publish optimized blog posts with your AI assistant",
   "type": "module",
   "bin": {