suparank 1.2.2 → 1.2.4

package/bin/suparank.js

@@ -23,6 +23,8 @@ const SUPARANK_DIR = path.join(os.homedir(), '.suparank')
 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')
+const CONTENT_DIR = path.join(SUPARANK_DIR, 'content')
+const STATS_FILE = path.join(SUPARANK_DIR, 'stats.json')
 
 // Production API URL
 const DEFAULT_API_URL = 'https://api.suparank.io'
@@ -514,6 +516,165 @@ function showVersion() {
   log('https://suparank.io', 'dim')
 }
 
+function loadStats() {
+  try {
+    if (fs.existsSync(STATS_FILE)) {
+      return JSON.parse(fs.readFileSync(STATS_FILE, 'utf-8'))
+    }
+  } catch (e) {}
+  return { tool_calls: 0, images_generated: 0, articles_created: 0, words_written: 0 }
+}
+
+function loadSession() {
+  try {
+    if (fs.existsSync(SESSION_FILE)) {
+      return JSON.parse(fs.readFileSync(SESSION_FILE, 'utf-8'))
+    }
+  } catch (e) {}
+  return null
+}
+
+function countSavedContent() {
+  try {
+    if (fs.existsSync(CONTENT_DIR)) {
+      const folders = fs.readdirSync(CONTENT_DIR).filter(f => {
+        const stat = fs.statSync(path.join(CONTENT_DIR, f))
+        return stat.isDirectory()
+      })
+      return folders.length
+    }
+  } catch (e) {}
+  return 0
+}
+
+function getRecentContent(limit = 3) {
+  try {
+    if (fs.existsSync(CONTENT_DIR)) {
+      const folders = fs.readdirSync(CONTENT_DIR)
+        .filter(f => fs.statSync(path.join(CONTENT_DIR, f)).isDirectory())
+        .map(f => {
+          const metaPath = path.join(CONTENT_DIR, f, 'metadata.json')
+          let meta = { title: f }
+          try {
+            if (fs.existsSync(metaPath)) {
+              meta = JSON.parse(fs.readFileSync(metaPath, 'utf-8'))
+            }
+          } catch (e) {}
+          return { folder: f, ...meta }
+        })
+        .sort((a, b) => (b.savedAt || '').localeCompare(a.savedAt || ''))
+        .slice(0, limit)
+      return folders
+    }
+  } catch (e) {}
+  return []
+}
+
+async function displayDashboard(config, project) {
+  const packageJson = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'))
+  const credentials = loadCredentials()
+  const session = loadSession()
+  const stats = loadStats()
+  const savedCount = countSavedContent()
+  const recentContent = getRecentContent(3)
+  const projectConfig = project?.config || {}
+
+  // Header
+  console.log()
+  log('╔══════════════════════════════════════════════════════════════════════════════╗', 'cyan')
+  log('║                         🚀 SUPARANK MCP SERVER                               ║', 'cyan')
+  log('╚══════════════════════════════════════════════════════════════════════════════╝', 'cyan')
+  console.log()
+
+  // Version and project info
+  log(`  Version: ${packageJson.version}`, 'dim')
+  log(`  Project: ${colors.bright}${project?.name || config.project_slug}${colors.reset}`, 'reset')
+  log(`  URL: ${projectConfig.site?.url || 'Not set'}`, 'dim')
+  console.log()
+
+  // Project Settings Box
+  log('┌─────────────────────────────────────────────────────────────────────────────┐', 'yellow')
+  log('│  📋 PROJECT SETTINGS (from Supabase)                                        │', 'yellow')
+  log('├─────────────────────────────────────────────────────────────────────────────┤', 'yellow')
+  log(`│  Word Count:      ${String(projectConfig.content?.default_word_count || 'Not set').padEnd(15)} │  Brand Voice: ${String(projectConfig.brand?.voice || 'Not set').substring(0, 25).padEnd(25)}│`, 'reset')
+  log(`│  Reading Level:   ${String(projectConfig.content?.reading_level ? `Grade ${projectConfig.content.reading_level}` : 'Not set').padEnd(15)} │  Target:      ${String(projectConfig.brand?.target_audience || 'Not set').substring(0, 25).padEnd(25)}│`, 'reset')
+  log(`│  Include Images:  ${String(projectConfig.content?.include_images ? 'Yes' : 'No').padEnd(15)} │  Niche:       ${String(projectConfig.site?.niche || 'Not set').substring(0, 25).padEnd(25)}│`, 'reset')
+  log(`│  Keywords:        ${String((projectConfig.seo?.primary_keywords || []).slice(0, 3).join(', ') || 'Not set').substring(0, 56).padEnd(56)}│`, 'reset')
+  log('└─────────────────────────────────────────────────────────────────────────────┘', 'yellow')
+  console.log()
+
+  // Integrations Status
+  log('┌─────────────────────────────────────────────────────────────────────────────┐', 'green')
+  log('│  🔌 INTEGRATIONS                                                            │', 'green')
+  log('├─────────────────────────────────────────────────────────────────────────────┤', 'green')
+
+  const wpStatus = credentials.wordpress?.secret_key || credentials.wordpress?.app_password ? '✅ Enabled' : '❌ Not configured'
+  const ghostStatus = credentials.ghost?.admin_api_key ? '✅ Enabled' : '❌ Not configured'
+  const imageStatus = credentials[credentials.image_provider]?.api_key ? `✅ ${credentials.image_provider}` : '❌ Not configured'
+  const webhookStatus = credentials.webhooks && Object.values(credentials.webhooks).some(Boolean) ? '✅ Enabled' : '❌ Not configured'
+  const externalMcps = credentials.external_mcps?.length || 0
+
+  log(`│  WordPress:     ${wpStatus.padEnd(20)} │  Ghost CMS:    ${ghostStatus.padEnd(20)}│`, 'reset')
+  log(`│  Image Gen:     ${imageStatus.padEnd(20)} │  Webhooks:     ${webhookStatus.padEnd(20)}│`, 'reset')
+  log(`│  External MCPs: ${String(externalMcps > 0 ? `✅ ${externalMcps} configured` : '❌ None').padEnd(58)}│`, 'reset')
+  log('└─────────────────────────────────────────────────────────────────────────────┘', 'green')
+  console.log()
+
+  // Session Status
+  log('┌─────────────────────────────────────────────────────────────────────────────┐', 'magenta')
+  log('│  📝 CURRENT SESSION                                                         │', 'magenta')
+  log('├─────────────────────────────────────────────────────────────────────────────┤', 'magenta')
+
+  if (session && session.articles?.length > 0) {
+    const totalWords = session.articles.reduce((sum, a) => sum + (a.wordCount || 0), 0)
+    const unpublished = session.articles.filter(a => !a.published).length
+    log(`│  Articles: ${String(session.articles.length).padEnd(5)} │  Words: ${String(totalWords).padEnd(8)} │  Unpublished: ${String(unpublished).padEnd(14)}│`, 'reset')
+
+    if (session.articles.length > 0) {
+      const latest = session.articles[session.articles.length - 1]
+      log(`│  Latest:   ${String(`"${latest.title?.substring(0, 45) || 'Untitled'}..."`).padEnd(63)}│`, 'reset')
+    }
+  } else {
+    log(`│  No active session - Start with: "Create a blog post about [topic]"         │`, 'dim')
+  }
+  log('└─────────────────────────────────────────────────────────────────────────────┘', 'magenta')
+  console.log()
+
+  // Recent Content
+  if (recentContent.length > 0) {
+    log('┌─────────────────────────────────────────────────────────────────────────────┐', 'blue')
+    log('│  📚 RECENT CONTENT                                                          │', 'blue')
+    log('├─────────────────────────────────────────────────────────────────────────────┤', 'blue')
+    recentContent.forEach((content, i) => {
+      const title = (content.title || content.folder).substring(0, 50)
+      const words = content.wordCount || '?'
+      const date = content.savedAt ? new Date(content.savedAt).toLocaleDateString() : '?'
+      log(`│  ${i + 1}. ${title.padEnd(50)} ${String(words + ' words').padEnd(12)} ${date.padEnd(10)}│`, 'reset')
+    })
+    log(`│  Total saved: ${String(savedCount + ' articles').padEnd(60)}│`, 'dim')
+    log('└─────────────────────────────────────────────────────────────────────────────┘', 'blue')
+    console.log()
+  }
+
+  // Stats (if available)
+  if (stats.tool_calls > 0 || stats.articles_created > 0) {
+    log('┌─────────────────────────────────────────────────────────────────────────────┐', 'cyan')
+    log('│  📊 USAGE STATS                                                             │', 'cyan')
+    log('├─────────────────────────────────────────────────────────────────────────────┤', 'cyan')
+    log(`│  Tool Calls: ${String(stats.tool_calls).padEnd(10)} │  Articles: ${String(stats.articles_created).padEnd(10)} │  Images: ${String(stats.images_generated).padEnd(10)}│`, 'reset')
+    log(`│  Words Written: ${String(stats.words_written?.toLocaleString() || 0).padEnd(58)}│`, 'reset')
+    log('└─────────────────────────────────────────────────────────────────────────────┘', 'cyan')
+    console.log()
+  }
+
+  // Ready message
+  log('─────────────────────────────────────────────────────────────────────────────', 'dim')
+  log('  MCP Server ready. Waiting for AI client connection...', 'green')
+  log('  Tip: Say "Create a blog post about [topic]" to start', 'dim')
+  log('─────────────────────────────────────────────────────────────────────────────', 'dim')
+  console.log()
+}
+
 async function checkForUpdates(showCurrent = false) {
   const packageJson = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf-8'))
   const currentVersion = packageJson.version
@@ -590,16 +751,30 @@ async function runUpdate() {
   }
 }
 
-function runMCP() {
+async function runMCP() {
   const config = loadConfig()
 
   if (!config) {
     log('No configuration found. Running setup...', 'yellow')
     console.log()
-    runSetup()
+    await runSetup()
     return
   }
 
+  // Fetch project data for dashboard
+  let project = null
+  try {
+    const result = await testConnection(config.api_key, config.project_slug, config.api_url)
+    if (result.success) {
+      project = result.project
+    }
+  } catch (e) {
+    // Continue without project data
+  }
+
+  // Display dashboard
+  await displayDashboard(config, project)
+
   // Find the MCP client script
   const mcpClientPaths = [
     path.join(import.meta.dirname, '..', 'mcp-client.js'),

package/mcp-client.js

@@ -144,6 +144,47 @@ function ensureContentDir() {
   return dir
 }
 
+/**
+ * Get the path to the stats file (~/.suparank/stats.json)
+ */
+function getStatsFile() {
+  return path.join(getSuparankDir(), 'stats.json')
+}
+
+/**
+ * Load usage stats
+ */
+function loadStats() {
+  try {
+    const file = getStatsFile()
+    if (fs.existsSync(file)) {
+      return JSON.parse(fs.readFileSync(file, 'utf-8'))
+    }
+  } catch (e) {}
+  return { tool_calls: 0, images_generated: 0, articles_created: 0, words_written: 0 }
+}
+
+/**
+ * Save usage stats
+ */
+function saveStats(stats) {
+  try {
+    ensureSuparankDir()
+    fs.writeFileSync(getStatsFile(), JSON.stringify(stats, null, 2))
+  } catch (e) {
+    log(`Error saving stats: ${e.message}`)
+  }
+}
+
+/**
+ * Increment a stat counter
+ */
+function incrementStat(key, amount = 1) {
+  const stats = loadStats()
+  stats[key] = (stats[key] || 0) + amount
+  saveStats(stats)
+}
+
 /**
  * Generate a slug from title for folder naming
  */
@@ -1368,6 +1409,21 @@ function buildWorkflowPlan(request, count, publishTo, withImages, project) {
 
   // Extract all settings from project.config (database schema)
   const targetWordCount = config.content?.default_word_count
+
+  // LOG ALL CONFIG VALUES FOR DEBUGGING
+  log('=== PROJECT CONFIG VALUES ===')
+  log(`Word Count Target: ${targetWordCount}`)
+  log(`Reading Level: ${config.content?.reading_level}`)
+  log(`Brand Voice: ${config.brand?.voice}`)
+  log(`Target Audience: ${config.brand?.target_audience}`)
+  log(`Primary Keywords: ${config.seo?.primary_keywords?.join(', ')}`)
+  log(`Include Images: ${config.content?.include_images}`)
+  log('=============================')
+
+  // CRITICAL: Validate word count is set
+  if (!targetWordCount || targetWordCount < 100) {
+    log(`WARNING: Word count not properly set! Got: ${targetWordCount}`)
+  }
   const readingLevel = config.content?.reading_level
   const includeImages = config.content?.include_images
   const brandVoice = config.brand?.voice
@@ -1573,27 +1629,40 @@ Use format: [IMAGE: description of what image should show]` : '**Note:** Images
     action: 'content_write',
     instruction: `Write the COMPLETE article following your outline.
 
-**⚠️ CRITICAL REQUIREMENTS (from project database):**
-- Word count: **${targetWordCount} words MINIMUM** - Count your words!
-- Reading level: **${readingLevelDisplay}** - Simple sentences, short paragraphs, no jargon
+╔══════════════════════════════════════════════════════════════════╗
+║  🚨 MANDATORY WORD COUNT: ${targetWordCount} WORDS MINIMUM 🚨     ║
+║  This is a strict requirement from the project settings.         ║
+║  The article will be REJECTED if under ${targetWordCount} words. ║
+╚══════════════════════════════════════════════════════════════════╝
+
+**Project Requirements (from Supabase database - DO NOT IGNORE):**
+- Word count: **${targetWordCount} words** (MINIMUM - not a suggestion!)
+- Reading level: **${readingLevelDisplay}** - Simple sentences, short paragraphs
 - Brand voice: ${brandVoice}
 - Target audience: ${targetAudience || 'General readers'}
 
+**To reach ${targetWordCount} words, you MUST:**
+- Write 8-10 substantial H2 sections (each 200-400 words)
+- Include detailed examples, statistics, and actionable advice
+- Add comprehensive FAQ section (5-8 questions)
+- Expand each point with thorough explanations
+
 **Content Structure:**
 - Engaging hook in first 2 sentences
-- All H2/H3 sections from your outline
-- Statistics, examples, and actionable tips in each section
+- All H2/H3 sections from your outline (expand each thoroughly!)
+- Statistics, examples, and actionable tips in EVERY section
 ${shouldGenerateImages ? '- Image placeholders: [IMAGE: description] where images should go' : ''}
-- FAQ section with 4-5 Q&As
+- FAQ section with 5-8 Q&As (detailed answers, not one-liners)
 - Strong conclusion with clear CTA
 
-**After writing, call 'save_content' with:**
+**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
 
-⚠️ DO NOT proceed until you've written ${targetWordCount}+ words!`,
+⛔ STOP! Before calling save_content, verify you have ${targetWordCount}+ words.
+   Count the words. If under ${targetWordCount}, ADD MORE CONTENT.`,
     store: 'article'
   })
 
@@ -1804,6 +1873,13 @@ async function executeOrchestratorTool(toolName, args, project) {
 
       let response = `# 🚀 Content Creation Workflow Started
 
+╔══════════════════════════════════════════════════════════════════════════════╗
+║  📊 PROJECT REQUIREMENTS (from Supabase database)                            ║
+║  Word Count: ${String(plan.settings.target_word_count).padEnd(6)} words (MINIMUM - strictly enforced!)      ║
+║  Brand Voice: ${String(plan.settings.brand_voice || 'Not set').substring(0, 50).padEnd(50)}     ║
+║  Target Audience: ${String(plan.settings.target_audience || 'Not set').substring(0, 45).padEnd(45)}     ║
+╚══════════════════════════════════════════════════════════════════════════════╝
+
 ## Your Request
 "${plan.request}"
 
@@ -1811,7 +1887,7 @@ async function executeOrchestratorTool(toolName, args, project) {
 - **URL:** ${plan.project_info.url}
 - **Niche:** ${plan.project_info.niche}
 
-## Content Settings (from database)
+## Content Settings (from database - DO NOT USE DEFAULTS)
 | Setting | Value |
 |---------|-------|
 | **Word Count** | ${plan.settings.target_word_count} words |
@@ -1887,6 +1963,10 @@ ${plan.steps[0].instruction}
       // Add to articles array (not overwriting previous articles!)
       sessionState.articles.push(newArticle)
 
+      // Track stats
+      incrementStat('articles_created')
+      incrementStat('words_written', wordCount)
+
       // Also keep in current working fields for backwards compatibility
       sessionState.title = title
       sessionState.article = content
@@ -1907,7 +1987,12 @@ ${plan.steps[0].instruction}
 
       const workflow = sessionState.currentWorkflow
       const targetWordCount = workflow?.settings?.target_word_count
-      const wordCountOk = targetWordCount ? wordCount >= targetWordCount * 0.9 : true // Allow 10% tolerance
+      // Only 5% tolerance - 2500 word target means minimum 2375 words
+      const wordCountOk = targetWordCount ? wordCount >= targetWordCount * 0.95 : true
+      const shortfall = targetWordCount ? targetWordCount - wordCount : 0
+
+      // Log word count check
+      log(`Word count check: ${wordCount} words (target: ${targetWordCount}, ok: ${wordCountOk})`)
 
       // Find next step
       const imageStep = workflow?.steps?.find(s => s.action === 'generate_images')
@@ -1954,7 +2039,19 @@ Use \`publish_content\` to publish all unpublished articles, or \`get_session\`
 **Keywords:** ${keywords.join(', ') || 'none specified'}
 **Images:** ${newArticle.imageUrl ? '1 cover' : 'no cover'}${newArticle.inlineImages.length > 0 ? ` + ${newArticle.inlineImages.length} inline` : ''}
 
-${targetWordCount && !wordCountOk ? `⚠️ **Warning:** Article is ${targetWordCount - wordCount} words short of the ${targetWordCount} word target.\n` : ''}
+${targetWordCount && !wordCountOk ? `
+╔══════════════════════════════════════════════════════════════════════════╗
+║  ⛔ WORD COUNT NOT MET - ${shortfall} WORDS SHORT!                        ║
+║  Target: ${targetWordCount} words | Actual: ${wordCount} words            ║
+║                                                                          ║
+║  The article does not meet the project's word count requirement.         ║
+║  Please EXPAND the content before publishing:                            ║
+║  - Add more detailed explanations to each section                        ║
+║  - Include additional examples and statistics                            ║
+║  - Expand the FAQ section with more questions                            ║
+║  - Add more H2 sections if needed                                        ║
+╚══════════════════════════════════════════════════════════════════════════╝
+` : ''}
 ${!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'}
@@ -2642,6 +2739,9 @@ async function executeImageGeneration(args) {
       // Persist session to file
       saveSession()
 
+      // Track stats
+      incrementStat('images_generated')
+
       const imageNumber = 1 + sessionState.inlineImages.length
       const totalImages = sessionState.currentWorkflow?.settings?.total_images || 1
       const imageType = imageNumber === 1 ? 'Cover Image' : `Inline Image ${imageNumber - 1}`
@@ -2705,6 +2805,9 @@ ${imageNumber < totalImages ? `\n**Next:** Generate ${totalImages - imageNumber}
       // Return base64 data URI
       const dataUri = `data:${mimeType};base64,${imageData}`
 
+      // Track stats
+      incrementStat('images_generated')
+
       return {
         content: [{
           type: 'text',
@@ -2819,6 +2922,9 @@ ${imageNumber < totalImages ? `\n**Next:** Generate ${totalImages - imageNumber}
           // Persist session to file
           saveSession()
 
+          // Track stats
+          incrementStat('images_generated')
+
           const imageNumber = 1 + sessionState.inlineImages.length
           const totalImages = sessionState.currentWorkflow?.settings?.total_images || 1
           const imageType = imageNumber === 1 ? 'Cover Image' : `Inline Image ${imageNumber - 1}`
@@ -3378,6 +3484,9 @@ async function main() {
     progress('Tool', `Executing ${name}`)
     log(`Executing tool: ${name}`)
 
+    // Track tool call stats
+    incrementStat('tool_calls')
+
     // Check if this is an orchestrator tool
     const orchestratorTool = ORCHESTRATOR_TOOLS.find(t => t.name === name)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "suparank",
-  "version": "1.2.2",
+  "version": "1.2.4",
   "description": "AI-powered SEO content creation MCP - generate and publish optimized blog posts with Claude, ChatGPT, or Cursor",
   "main": "mcp-client.js",
   "type": "module",