marketing-mindset 1.14.0 → 1.14.2

package/README.md

@@ -67,7 +67,9 @@ npx marketing-mindset utm --file article.md --source devto --medium article --ca
 
 `--file` rewrites the file in place and reports how many links it tagged; a second run tags nothing
 (idempotent). Third-party links are left alone, existing query params are kept, and sentence
-punctuation after a URL stays where it belongs. The convention it writes:
+punctuation after a URL stays where it belongs. Tagging a page of your own site?
+Pass `--skip-host <site>` so its internal links stay clean — an internal link with UTM
+restarts the session and doubles the visit. The convention it writes:
 
 | parameter | what it holds | examples |
 |---|---|---|

package/bin/cli.js

@@ -75,7 +75,7 @@ const OUR_HOSTS = [
   "gymcamanalytics.com", "releazer.online", "dublicator.online", "spbilo.ru", "avtootkliki.ru",
 ];
 
-function utmTag(url, source, medium, campaign, content) {
+function utmTag(url, source, medium, campaign, content, skipHosts) {
   if (!/^https?:\/\//i.test(url)) return url;
   let host;
   try {
@@ -83,6 +83,7 @@ function utmTag(url, source, medium, campaign, content) {
   } catch (e) {
     return url;
   }
+  if (skipHosts && skipHosts.indexOf(host) !== -1) return url; // internal link of the page's own site
   if (OUR_HOSTS.indexOf(host) === -1) return url; // only our own destinations
   if (/[?&]utm_source=/i.test(url)) return url; // idempotent
   const parts = [];
@@ -99,6 +100,12 @@ function runUtm(opts) {
   const medium = opts.medium ? String(opts.medium) : "referral";
   const campaign = opts.campaign ? String(opts.campaign) : null;
   const content = opts.content ? String(opts.content) : null;
+  // A file that IS a page of our own site should not get utm on its internal links:
+  // pass --skip-host <that site> (comma separated for several).
+  const skipHosts = String(opts["skip-host"] || opts.skipHost || "")
+    .split(",")
+    .map((h) => h.trim().replace(/^www\./, ""))
+    .filter(Boolean);
 
   // Tag links in prose, but never inside fenced blocks or `inline code` — those are examples.
   function tagText(text) {
@@ -118,7 +125,7 @@ function runUtm(opts) {
             const tailMatch = /[.,;:!?]+$/.exec(u); // sentence punctuation is not part of the url
             const tail = tailMatch ? tailMatch[0] : "";
             const core = tail ? u.slice(0, -tail.length) : u;
-            const t = utmTag(core, source, medium, campaign, content);
+            const t = utmTag(core, source, medium, campaign, content, skipHosts);
             if (t !== core) n++;
             return t + tail;
           });
@@ -155,10 +162,11 @@ function runUtm(opts) {
     - internal links of your own site carry NO utm — they would restart the session
     - tag only links that leave for our own domains; a third-party link stays clean
     - never tag twice: a url that already has utm_source is returned untouched
-    - existing query params are kept`);
+    - existing query params are kept
+    - tagging a page of your own site? pass --skip-host <site> so its internal links stay clean`);
     return 1;
   }
-  const tagged = utmTag(url, source, medium, campaign, content);
+  const tagged = utmTag(url, source, medium, campaign, content, skipHosts);
   console.log(tagged);
   if (tagged === url) {
     console.error("(not tagged: internal/no-own-domain/already tagged — see rules)");
@@ -1117,7 +1125,10 @@ if (cmd === "sample") {
   }
   console.log("## " + hit.title + "\n" + hit.body.join("\n").trim());
 } else if (cmd === "utm") {
-  process.exit(runUtm(flags(rest)));
+  const pos = rest.filter((a) => !a.startsWith("--"));
+  const o = flags(rest);
+  if (pos.length && !o.url) o.url = pos[0];
+  process.exit(runUtm(o));
 } else if (cmd === "install") {
   require(path.join(__dirname, "install.js"));
 } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "marketing-mindset",
-  "version": "1.14.0",
+  "version": "1.14.2",
   "description": "A marketer's operating mindset as an installable agent skill and CLI: test-size floors, kill rules, honest verdicts on finished tests, which funnel step can fund a verdict, which channel can actually fund a verdict, the lift a volume can read, a queue of readable tests with read-out dates, the cost of one readable verdict, and UTM tagging on every outbound link. npx marketing-mindset sample|kill|verdict|unit|fit|queue|cost|mde|budget|brief|plan|warmup|aeo|utm|jd|sections|read|install.",
   "keywords": [
     "agent-skill",