wpfleet 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,30 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+## [1.0.0] — 2026-03-02
+
+### Added
+- Initial release
+- **sites list** — List all configured WordPress sites with online/offline status
+- **sites add** — Add a new WordPress site to the fleet
+- **sites remove** — Remove a site from configuration
+- **stats** — Fetch post/page counts and last publish date for all sites
+- **health** — Check response time, SSL expiry, WP version, plugin count, pending updates
+- **publish** — Publish a markdown/HTML article to a specific site
+- **bulk-publish** — Publish articles to multiple sites in batch
+- **interlink** — Add internal links between posts on a single site
+- **crosslink** — Add cross-site links between posts across the fleet
+- **traffic** — Display traffic stats (requires GA4 integration)
+- **report** — Generate a full fleet health report in markdown
+- **update** — Trigger WordPress core/plugin/theme updates remotely
+- **security** — Audit security headers, exposed endpoints, and common vulnerabilities
+- **ai-write** — AI-powered article generation with SEO optimization (BYOK OpenAI/Anthropic)
+- **ai-optimize** — AI-powered SEO scoring and meta optimization for existing posts (BYOK)
+- BYOK AI: supports OpenAI (`gpt-4o-mini` default) and Anthropic (`claude-3-5-haiku-latest`)
+- YAML configuration (`wpfleet.yml`) for multi-site management
+- Cost tracking for AI operations
+
+### Fixed
+- JSON parse error in ai-optimize when AI returns markdown-fenced responses
+- `villasaintjean.com` requires `www.` prefix due to 301 redirect

package/README.md

@@ -0,0 +1,143 @@
+# ⚡ wpfleet
+
+**Manage your WordPress network from the terminal.**
+
+Stop juggling 20+ wp-admin tabs. One command to monitor, publish, interlink, and report across your entire WordPress fleet.
+
+```bash
+$ wpfleet health
+
+┌──────────────────┬──────────┬────────────┬────────────┬─────────┬─────────┐
+│ Site             │ Response │ SSL Expiry │ WP Version │ Plugins │ Updates │
+├──────────────────┼──────────┼────────────┼────────────┼─────────┼─────────┤
+│ myblog           │ 245ms    │ 78d        │ 6.7.1      │ 12      │ 0       │
+│ niche-site       │ 1830ms   │ 12d  ⚠️    │ 6.7.1      │ 18      │ 3  🔴  │
+│ affiliate-hub    │ 380ms    │ 156d       │ 6.7.1      │ 9       │ 0       │
+└──────────────────┴──────────┴────────────┴────────────┴─────────┴─────────┘
+```
+
+## Install
+
+```bash
+npm install -g wpfleet
+```
+
+## Quick Start
+
+**1. Add your sites:**
+```bash
+wpfleet sites add
+# → Interactive: name, URL, WP credentials
+# → Auto-validates your WP REST API connection
+```
+
+**2. See your fleet:**
+```bash
+wpfleet sites list
+```
+
+**3. Check everything's running:**
+```bash
+wpfleet health
+```
+
+That's it. Your entire network in one terminal.
+
+## Commands
+
+### Fleet Management
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet sites list` | All your sites, online/offline status |
+| `wpfleet sites add` | Add a site (interactive, validates API) |
+| `wpfleet sites remove <name>` | Remove a site |
+
+### Monitoring
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet health [site]` | Response time, SSL, WP version, plugin status |
+| `wpfleet stats [site]` | Post count, page count, last published date |
+
+### Publishing *(coming soon)*
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet publish article.md --site myblog` | Publish markdown to any site |
+| `wpfleet bulk-publish ./articles/ --distribute` | Distribute articles across your network |
+| `wpfleet schedule article.md --date "2026-04-01 09:00"` | Schedule posts |
+
+### Internal Linking *(coming soon)*
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet interlink --site myblog` | Detect orphan pages, suggest internal links |
+| `wpfleet interlink --auto` | Auto-insert relevant internal links |
+| `wpfleet crosslink siteA → siteB` | Cross-site linking opportunities |
+
+### Analytics *(coming soon)*
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet traffic` | GA4 traffic across all sites in one table |
+| `wpfleet top-pages --site myblog` | Most visited pages |
+| `wpfleet report --month 2026-02 --pdf` | Auto-generated monthly PDF report |
+
+### Maintenance *(coming soon)*
+
+| Command | What it does |
+|---------|-------------|
+| `wpfleet update plugins --all` | Update plugins across the network |
+| `wpfleet security-scan` | Check vulnerabilities, headers, permissions |
+
+## Configuration
+
+wpfleet uses a YAML config file. It looks for `wpfleet.yml` in the current directory, then `~/.wpfleet/config.yml`.
+
+```yaml
+sites:
+  - name: myblog
+    url: https://myblog.com
+    wp_user: admin
+    wp_app_password: xxxx xxxx xxxx xxxx xxxx xxxx
+
+  - name: niche-site
+    url: https://niche-site.com
+    wp_user: admin
+    wp_app_password: yyyy yyyy yyyy yyyy yyyy yyyy
+```
+
+### WordPress App Passwords
+
+wpfleet uses [Application Passwords](https://make.wordpress.org/core/2020/11/05/application-passwords-integration-guide/) (built into WordPress 5.6+). No plugins needed.
+
+To create one:
+1. Go to **wp-admin → Users → Profile**
+2. Scroll to **Application Passwords**
+3. Enter name: `wpfleet-cli`
+4. Click **Add New Application Password**
+5. Copy the password into your `wpfleet.yml`
+
+## Who is this for?
+
+- **SEO affiliates** managing 10-100+ niche sites
+- **WordPress agencies** with multiple client sites
+- **Content publishers** running blog networks
+- **Anyone** tired of logging into wp-admin 20 times a day
+
+## Pricing
+
+| Plan | Sites | Price |
+|------|-------|-------|
+| **Free** | Up to 5 | $0 |
+| **Pro** | Up to 50 | $49/mo |
+| **Agency** | Unlimited | $199/mo |
+
+## Built by
+
+[Recognity](https://recognity.fr) — Digital consulting & automation, Paris.
+
+## License
+
+MIT

package/bin/wpfleet.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import '../src/index.js';

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "wpfleet",
+  "version": "1.0.0",
+  "description": "CLI tool to manage a network of WordPress blogs from the terminal",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "wpfleet": "./bin/wpfleet.js"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test test/config.test.js test/publish.test.js test/interlink.test.js test/report.test.js test/security.test.js test/traffic.test.js test/update.test.js"
+  },
+  "dependencies": {
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "cli-table3": "^0.6.3",
+    "commander": "^12.0.0",
+    "gray-matter": "^4.0.3",
+    "inquirer": "^9.2.0",
+    "js-yaml": "^4.1.0",
+    "marked": "^17.0.3"
+  },
+  "author": "Recognity <anthony@recognity.fr> (https://recognity.fr)",
+  "homepage": "https://recognity.fr",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/recognity/wpfleet.git"
+  },
+  "keywords": [
+    "wordpress",
+    "wp",
+    "cli",
+    "multi-site",
+    "fleet",
+    "management",
+    "seo",
+    "ai",
+    "blog",
+    "publish",
+    "bulk"
+  ]
+}

package/src/ai/client.js

@@ -0,0 +1,149 @@
+import axios from 'axios';
+import chalk from 'chalk';
+import { loadConfig } from '../config.js';
+
+// Pricing per 1M tokens (input / output)
+const PRICING = {
+  'gpt-4o-mini': { input: 0.15, output: 0.60 },
+  'gpt-4o': { input: 5.00, output: 15.00 },
+  'claude-haiku-4-5-20251001': { input: 0.80, output: 4.00 },
+  'claude-haiku-4-5': { input: 0.80, output: 4.00 },
+  'claude-sonnet-4-6': { input: 3.00, output: 15.00 },
+  'claude-opus-4-6': { input: 15.00, output: 75.00 },
+};
+
+export function getAiConfig() {
+  // Env vars take priority
+  if (process.env.OPENAI_API_KEY) {
+    return {
+      provider: 'openai',
+      apiKey: process.env.OPENAI_API_KEY,
+      model: process.env.OPENAI_MODEL || 'gpt-4o-mini',
+    };
+  }
+  if (process.env.ANTHROPIC_API_KEY) {
+    return {
+      provider: 'anthropic',
+      apiKey: process.env.ANTHROPIC_API_KEY,
+      model: process.env.ANTHROPIC_MODEL || 'claude-haiku-4-5-20251001',
+    };
+  }
+
+  // Config file fallback
+  try {
+    const config = loadConfig();
+    if (config.ai && config.ai.api_key) {
+      return {
+        provider: config.ai.provider || 'openai',
+        apiKey: config.ai.api_key,
+        model: config.ai.model || 'gpt-4o-mini',
+      };
+    }
+  } catch {}
+
+  return null;
+}
+
+function estimateCost(model, inputTokens, outputTokens) {
+  const pricing = PRICING[model];
+  if (!pricing) return null;
+  return (inputTokens * pricing.input + outputTokens * pricing.output) / 1_000_000;
+}
+
+async function callOpenAI(config, systemPrompt, userPrompt, maxTokens) {
+  const res = await axios.post(
+    'https://api.openai.com/v1/chat/completions',
+    {
+      model: config.model,
+      messages: [
+        { role: 'system', content: systemPrompt },
+        { role: 'user', content: userPrompt },
+      ],
+      max_tokens: maxTokens,
+    },
+    {
+      headers: {
+        Authorization: `Bearer ${config.apiKey}`,
+        'Content-Type': 'application/json',
+      },
+      timeout: 120000,
+      validateStatus: () => true,
+    }
+  );
+
+  if (res.status !== 200) {
+    throw new Error(`OpenAI error ${res.status}: ${res.data?.error?.message || JSON.stringify(res.data)}`);
+  }
+
+  return {
+    content: res.data.choices[0].message.content,
+    inputTokens: res.data.usage.prompt_tokens,
+    outputTokens: res.data.usage.completion_tokens,
+  };
+}
+
+async function callAnthropic(config, systemPrompt, userPrompt, maxTokens) {
+  const res = await axios.post(
+    'https://api.anthropic.com/v1/messages',
+    {
+      model: config.model,
+      max_tokens: maxTokens,
+      system: systemPrompt,
+      messages: [{ role: 'user', content: userPrompt }],
+    },
+    {
+      headers: {
+        'x-api-key': config.apiKey,
+        'anthropic-version': '2023-06-01',
+        'Content-Type': 'application/json',
+      },
+      timeout: 120000,
+      validateStatus: () => true,
+    }
+  );
+
+  if (res.status !== 200) {
+    throw new Error(`Anthropic error ${res.status}: ${res.data?.error?.message || JSON.stringify(res.data)}`);
+  }
+
+  return {
+    content: res.data.content[0].text,
+    inputTokens: res.data.usage.input_tokens,
+    outputTokens: res.data.usage.output_tokens,
+  };
+}
+
+export async function aiComplete({ systemPrompt, userPrompt, maxTokens = 2000 }) {
+  const config = getAiConfig();
+  if (!config) {
+    throw new Error(
+      'No AI API key configured. Set OPENAI_API_KEY or ANTHROPIC_API_KEY, or add ai.api_key to wpfleet.yml'
+    );
+  }
+
+  const inputEst = Math.ceil((systemPrompt.length + userPrompt.length) / 4);
+  const costEst = estimateCost(config.model, inputEst, maxTokens);
+  process.stderr.write(
+    chalk.dim(`AI: ${config.provider}/${config.model}`) +
+    (costEst !== null ? chalk.dim(` | Est. cost: $${costEst.toFixed(4)}`) : '') +
+    '\n'
+  );
+
+  let result;
+  if (config.provider === 'openai') {
+    result = await callOpenAI(config, systemPrompt, userPrompt, maxTokens);
+  } else if (config.provider === 'anthropic') {
+    result = await callAnthropic(config, systemPrompt, userPrompt, maxTokens);
+  } else {
+    throw new Error(`Unknown AI provider: ${config.provider}`);
+  }
+
+  const actualCost = estimateCost(config.model, result.inputTokens, result.outputTokens);
+  process.stderr.write(
+    chalk.dim(`AI: ${result.inputTokens} in / ${result.outputTokens} out`) +
+    (actualCost !== null ? chalk.dim(` | Cost: $${actualCost.toFixed(4)}`) : '') +
+    '\n'
+  );
+
+  return result.content;
+}

package/src/ai/seo-prompts.js

@@ -0,0 +1,117 @@
+/**
+ * SEO-specialized prompts for content generation and optimization.
+ */
+
+export function articleGenerationPrompt({ topic, keywords = [], words = 1500, lang = 'en', siteContext = '' }) {
+  const kwList = keywords.length ? keywords.join(', ') : topic;
+
+  const langInstruction = lang === 'fr'
+    ? 'Write in French. Follow French SEO rules: natural French phrasing, French stop words are acceptable in headings, accents in content but not in slugs.'
+    : lang === 'en'
+    ? 'Write in English.'
+    : `Write in ${lang}.`;
+
+  return {
+    system: `You are an expert SEO content writer. You create high-quality, well-structured articles optimized for search engines without keyword stuffing. You follow E-E-A-T principles (Experience, Expertise, Authoritativeness, Trustworthiness). ${langInstruction} Return ONLY the requested markdown, no commentary.`,
+
+    user: `Write a ${words}-word SEO-optimized article about: "${topic}"
+
+Target keywords: ${kwList}
+${siteContext ? `\nExisting site content (use for internal link suggestions):\n${siteContext}` : ''}
+
+Return ONLY a markdown document with this exact structure:
+
+---
+title: [SEO title, 50-60 characters, include primary keyword]
+meta_description: [150-160 characters, include primary keyword, compelling CTA]
+slug: [url-friendly slug, no accents, hyphens only]
+keywords: [${keywords.length ? keywords.map(k => `"${k}"`).join(', ') : `"${topic}"`}]
+lang: ${lang}
+---
+
+# [H1 matching title]
+
+[Intro paragraph — primary keyword in first 100 words, hook the reader]
+
+## [H2 section title]
+
+[content — 200-300 words]
+
+## [H2 section title]
+
+[content — 200-300 words]
+
+## [H2 section title]
+
+[content — 200-300 words]
+
+## [Additional H2 sections as needed]
+
+## Conclusion
+
+[Summary paragraph with CTA]
+
+## Internal Link Suggestions
+
+- [anchor text] → [suggested page/topic on the site]
+- [anchor text] → [suggested page/topic on the site]
+
+Requirements:
+- Primary keyword in: title, H1, first paragraph, at least 2 H2s, meta description
+- 3-6 H2 sections total, H3 subsections where helpful
+- Natural keyword density (1-2%), never stuffed
+- Suggest 2-3 relevant internal links at the end
+- Total length: ~${words} words (excluding front-matter)`,
+  };
+}
+
+export function metaOptimizationPrompt({ title, content, currentMeta = '', url = '' }) {
+  const stripped = content.replace(/<[^>]+>/g, ' ').replace(/\s+/g, ' ').trim().slice(0, 2500);
+
+  return {
+    system: 'You are an expert SEO specialist. Analyze blog post content and provide optimized meta tags with actionable recommendations. Return only valid JSON.',
+
+    user: `Analyze this WordPress post and return SEO optimization suggestions.
+
+URL: ${url || '(not provided)'}
+Current Title: ${title}
+Current Meta Description: ${currentMeta || '(none)'}
+Content: ${stripped}
+
+Return JSON with this exact structure:
+{
+  "score": <integer 0-100>,
+  "issues": ["issue 1", "issue 2"],
+  "optimized_title": "improved title (50-60 chars, include primary keyword)",
+  "optimized_meta": "improved meta description (150-160 chars, include keyword + CTA)",
+  "primary_keyword": "main keyword detected",
+  "keyword_suggestions": ["primary keyword", "secondary keyword"],
+  "recommendations": ["specific actionable fix 1", "specific actionable fix 2", "specific actionable fix 3"]
+}`,
+  };
+}
+
+export function batchScoringPrompt({ posts }) {
+  const list = posts.map((p, i) =>
+    `${i + 1}. ID:${p.id} | Title: "${p.title}" | Words: ${p.wordCount || '?'} | Has meta: ${p.hasMeta ? 'yes' : 'no'}`
+  ).join('\n');
+
+  return {
+    system: 'You are an SEO auditor. Score blog posts for optimization potential. Return only valid JSON.',
+
+    user: `Score these ${posts.length} posts for SEO optimization potential. Evaluate based on: title length and keyword presence, word count (aim for 800+), slug quality, and meta description presence.
+
+Posts:
+${list}
+
+Return a JSON array (one object per post, same order):
+[
+  {
+    "id": <post id>,
+    "score": <integer 0-100>,
+    "priority": "high|medium|low",
+    "top_issue": "main SEO problem in one sentence"
+  }
+]`,
+  };
+}