SEO Engine V4: Parametric Advanced Writing constraints (POV, Intent, Tone, Size)

database/local_db.json

@@ -25,6 +25,12 @@
     "active_experiments": 0
   },
   "telegram_log": [
+    {
+      "direction": "OUT",
+      "chatId": "8743583463",
+      "text": "<b>VinOS Daily Check-in</b>\nHow is the Token Gashapon project coming along? Ready for the next arbitrage move?",
+      "ts": "2026-03-21T19:17:10.784Z"
+    },
     {
       "direction": "OUT",
       "chatId": "8743583463",

server.js

@@ -392,36 +392,44 @@ app.post('/api/telegram-webhook', async (req, res) => {
                     }
                 }
             } else if (userText.toLowerCase().startsWith('/write')) {
-                const parts = userText.split(' ');
+                // Parse arguments smartly handling quotes: /write site "Topic" size "POV" "Intent" "Tone"
+                const args = userText.match(/(?:[^\s"']+|"[^"]*"|'[^']*')+/g) || [];
                 
-                let targetSiteId = null;
-                let size = 'medium';
-                let topicIndex = 1;
+                // Remove quotes from matched strings
+                const cleanArgs = args.map(arg => arg.replace(/^["'](.*)["']$/, '$1'));
 
                 let sites = {};
                 try { sites = JSON.parse(process.env.WP_SITES_JSON || "{}"); } catch(e){}
                 const siteKeys = Object.keys(sites);
-
-                if (siteKeys.includes(parts[1])) {
-                    targetSiteId = parts[1];
-                    topicIndex++;
-                }
-
-                const possibleSize = parts[topicIndex]?.toLowerCase();
-                if (['short', 'medium', 'dense'].includes(possibleSize)) {
-                    size = possibleSize;
-                    topicIndex++;
-                }
-                
-                const topic = parts.slice(topicIndex).join(' ');
-                
-                if (!topic) {
-                    const siteList = siteKeys.length > 0 ? `\n\n🏢 <b>Available Sites:</b> ${siteKeys.join(', ')}` : '\n\n⚠️ No sites configured in WP_SITES_JSON.';
-                    await apiCaller.sendTelegramMessage(chatId, `❌ Usage: /write [siteName] [short|medium|dense] [topic]${siteList}`);
+                const defaultSite = siteKeys.length > 0 ? siteKeys[0] : 'None';
+
+                if (cleanArgs.length < 7) {
+                    const helpMsg = `⚠️ <b>Missing Parameters for /write</b>\n\n` +
+                    `To architect an elite SEO article, I need instructions. Please use quotes for multi-word parameters.\n\n` +
+                    `<b>Structure:</b>\n` +
+                    `/write [SiteID] "[Topic]" [Size] "[POV]" "[Intent]" "[Tone]"\n\n` +
+                    `<b>Available Site IDs:</b> ${siteKeys.join(', ') || 'Configure WP_SITES_JSON'}\n` +
+                    `<b>Sizes:</b> short, medium, dense\n` +
+                    `<b>POV:</b> "1st person singular", "1st person plural", "2nd person", "3rd person"\n\n` +
+                    `<b>Example:</b>\n` +
+                    `/write ${defaultSite} "Agentic Workflow" medium "1st person plural" "Educational" "Authoritative"`;
+                    
+                    await apiCaller.sendTelegramMessage(chatId, helpMsg);
                 } else {
-                    const siteLabel = targetSiteId ? `[Site: ${targetSiteId}]` : '[Default Site]';
-                    await apiCaller.sendTelegramMessage(chatId, `📝 <b>SEO Engine:</b> Architecting 100% Unique [${size.toUpperCase()}] Article on "${topic}" with Dynamic Images...`);
-                    const articleRes = await seoWriter.generateArticle(size, topic);
+                    const targetSiteId = cleanArgs[1];
+                    const topic = cleanArgs[2];
+                    const size = cleanArgs[3].toLowerCase();
+                    const pov = cleanArgs[4];
+                    const intent = cleanArgs[5];
+                    const tone = cleanArgs[6];
+                    
+                    if (!siteKeys.includes(targetSiteId)) {
+                        await apiCaller.sendTelegramMessage(chatId, `❌ Unknown Site ID: ${targetSiteId}\nAvailable: ${siteKeys.join(', ')}`);
+                        return;
+                    }
+
+                    await apiCaller.sendTelegramMessage(chatId, `📝 <b>SEO Engine:</b> Architecting 100% Unique [${size.toUpperCase()}] Article on "${topic}"...\n<b>Tone:</b> ${tone}\n<b>POV:</b> ${pov}`);
+                    const articleRes = await seoWriter.generateArticle(size, pov, intent, tone, topic);
                     if (articleRes.success) {
                         await apiCaller.sendTelegramMessage(chatId, `✅ <b>Article Generated!</b> Scoring EEAT...`);
                         const scoreRes = await seoWriter.scoreEEAT(articleRes.html);

skills/seo_writer.js

@@ -9,7 +9,7 @@ class SeoWriter {
     /**
      * Generates a complete SEO article including Meta tags and JSON-LD schema.
      */
-    async generateArticle(size, topic) {
+    async generateArticle(size, pov, intent, tone, topic) {
         console.log(`[SEO Writer] Architecting ${size} article on: ${topic}`);
 
         let words = "1500 - 2500";
@@ -23,6 +23,9 @@ Write a comprehensive, EEAT-compliant article about: "${topic}"
 PARAMETERS:
 - Length: ${words} words.
 - Images: Minimum of ${minImages} images.
+- Point of View (POV): ${pov}
+- Search Intent: ${intent}
+- Tone of Voice: ${tone}
 
 CRITICAL RULES:
 1. STRICT HTML ONLY: You MUST format the output entirely in HTML. Use <strong>, <em>, <h2>, <h3>, <ul>, <p>. YOU ARE FORBIDDEN FROM USING MARKDOWN ASTERISKS (**bold**).