elementor-mcp-agent 1.1.0 → 1.3.0

package/package.json

@@ -1,19 +1,20 @@
 {
   "name": "elementor-mcp-agent",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "mcpName": "io.github.Mogacode-ma/elementor-mcp-agent",
-  "description": "Agentic MCP server for WordPress Elementor \u2014 multi-site management, safe Elementor data editing, template import/export, CSS flush, version tracking. Built for agencies running many client sites.",
+  "description": "Agentic MCP server for WordPress Elementor — multi-site management, safe Elementor data editing, template import/export, CSS flush, version tracking. Built for agencies running many client sites.",
   "type": "module",
   "main": "./dist/server.js",
   "bin": {
     "elementor-mcp-agent": "dist/server.js"
   },
   "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
     "ARCHITECTURE.md",
-    "resources"
+    "LICENSE",
+    "README.md",
+    "dist",
+    "resources",
+    "scripts"
   ],
   "scripts": {
     "build": "tsup",
@@ -29,6 +30,7 @@
     "test:coverage": "vitest run --coverage",
     "inspector": "npx @modelcontextprotocol/inspector node dist/server.js",
     "docs:fetch": "tsx scripts/fetch-elementor-docs.ts",
+    "postinstall": "node scripts/postinstall.cjs || true",
     "prepublishOnly": "npm run lint && npm run typecheck && npm run test && npm run build"
   },
   "keywords": [
@@ -48,6 +50,10 @@
     "url": "https://github.com/Mogacode-ma/elementor-mcp-agent.git"
   },
   "homepage": "https://github.com/Mogacode-ma/elementor-mcp-agent",
+  "funding": {
+    "type": "github",
+    "url": "https://github.com/Mogacode-ma/elementor-mcp-agent"
+  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -70,4 +76,4 @@
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   }
-}
+}

package/scripts/fetch-elementor-docs.ts

@@ -0,0 +1,26 @@
+/**
+ * Fetch and convert a curated set of Elementor developer docs to local Markdown
+ * for MCP `resources/list` exposure.
+ *
+ * This is intentionally small (handful of high-signal pages) — we're not
+ * trying to mirror the entire site. Quality > quantity for token budget.
+ *
+ * Run: `npm run docs:fetch`
+ */
+const SOURCES: Array<{ slug: string; url: string; title: string }> = [
+  // Hand-curated set. Expand cautiously — every entry adds tokens to the LLM context window.
+  { slug: "introduction", url: "https://developer.elementor.com/docs/getting-started/", title: "Getting started" },
+  { slug: "widgets-overview", url: "https://developer.elementor.com/docs/widgets/", title: "Widgets overview" },
+  { slug: "hooks", url: "https://developer.elementor.com/docs/hooks/", title: "Hooks reference" },
+];
+
+async function main() {
+  console.error(`Fetching ${SOURCES.length} doc pages...`);
+  // Skeleton — actual scraping/Markdown conversion would use a fetch + html-to-md pipeline.
+  // We ship a hand-written corpus in resources/elementor-docs/ by default; this script
+  // is the future-proofing path for automated refresh.
+  console.error("This script is a placeholder. The curated docs in resources/elementor-docs/");
+  console.error("are hand-written for v0.1.0. Automated fetching is on the roadmap.");
+}
+
+main();

package/scripts/postinstall.cjs

@@ -0,0 +1,64 @@
+#!/usr/bin/env node
+/**
+ * Post-install greeting — shown once after `npm install`.
+ *
+ * Discreet by design:
+ *   - Skip on CI=true (CI/CD shouldn't see this)
+ *   - Skip on --silent / loglevel error
+ *   - Skip on SUPPRESS_INSTALL_MESSAGE=1
+ *   - Skip if already shown (marker in node_modules/.cache)
+ *
+ * Old-ezine style: just an honest word to the reader. No tracking.
+ */
+"use strict";
+
+const fs = require("node:fs");
+const path = require("node:path");
+
+const SUPPRESS_VARS = [
+  process.env.CI,
+  process.env.SUPPRESS_INSTALL_MESSAGE,
+  process.env.DISABLE_OPENCOLLECTIVE,
+  process.env.ADBLOCK,
+  process.env.npm_config_loglevel === "silent" ? "1" : "",
+  process.env.npm_config_loglevel === "error" ? "1" : "",
+  process.env.npm_config_loglevel === "warn" ? "1" : "",
+];
+if (SUPPRESS_VARS.some(Boolean)) process.exit(0);
+
+try {
+  const root = process.env.INIT_CWD || process.cwd();
+  const markerDir = path.join(root, "node_modules", ".cache", "elementor-mcp-agent");
+  const markerFile = path.join(markerDir, "greeted");
+  if (fs.existsSync(markerFile)) process.exit(0);
+  fs.mkdirSync(markerDir, { recursive: true });
+  fs.writeFileSync(markerFile, new Date().toISOString());
+} catch {
+  // If we can't write the marker, show once. No harm if shown again next install.
+}
+
+const tty = process.stderr.isTTY || process.stdout.isTTY;
+const c = tty
+  ? { dim: "\x1b[2m", reset: "\x1b[0m", cyan: "\x1b[36m", yellow: "\x1b[33m" }
+  : { dim: "", reset: "", cyan: "", yellow: "" };
+
+const lines = [
+  "",
+  `  ${c.dim}─────────────────────────────────────────────────────────${c.reset}`,
+  `  Thanks for installing ${c.cyan}elementor-mcp-agent${c.reset}.`,
+  "",
+  `  I hope it saves you time managing your Elementor sites`,
+  `  with Claude (or your favorite MCP client).`,
+  "",
+  `  To say hi, report a bug, or share what you're building:`,
+  `      ${c.cyan}https://github.com/Mogacode-ma/elementor-mcp-agent${c.reset}`,
+  "",
+  `  A ${c.yellow}⭐${c.reset} helps other agencies running Elementor sites find this.`,
+  `  A drive-by "hello" in Discussions is just as welcome.`,
+  "",
+  `  ${c.dim}— Patrick (Mogacode, Morocco)${c.reset}`,
+  `  ${c.dim}─────────────────────────────────────────────────────────${c.reset}`,
+  "",
+];
+
+process.stderr.write(lines.join("\n"));