marketing-mindset 1.0.0 → 1.1.0

package/bin/cli.js

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/* marketing-mindset CLI — the skill and its numbers without opening a file.
+ *   marketing-mindset                help + the test-size floors
+ *   marketing-mindset sample         required per-arm sample size for a two-proportion test
+ *   marketing-mindset kill           the kill rule for a running test
+ *   marketing-mindset sections       list every section of SKILL.md
+ *   marketing-mindset read <text>    print one section by fuzzy title match
+ *   marketing-mindset install        copy the skill into your agent's skills directory
+ */
+const fs = require("fs");
+const path = require("path");
+
+const pkgRoot = path.join(__dirname, "..");
+const SKILL = path.join(pkgRoot, "skill", "SKILL.md");
+
+const ZA = { "0.05": 1.9599639845, "0.01": 2.5758293036, "0.1": 1.6448536270, "0.975": 1.9599639845 };
+const ZB = { "0.8": 0.8416212336, "0.9": 1.2815515655 };
+
+function sampleSize(rate, lift, power, alpha) {
+  const p1 = Math.min(Math.max(rate, 0.000001), 0.999999);
+  const p2 = Math.min(p1 * (1 + lift), 0.999999);
+  const pbar = (p1 + p2) / 2;
+  const za = ZA[String(alpha)] || ZA["0.05"];
+  const zb = ZB[String(power)] || ZB["0.8"];
+  const num = Math.pow(za * Math.sqrt(2 * pbar * (1 - pbar)) + zb * Math.sqrt(p1 * (1 - p1) + p2 * (1 - p2)), 2);
+  return Math.ceil(num / Math.pow(p2 - p1, 2));
+}
+
+function flags(argv) {
+  const out = {};
+  argv.forEach((a, i) => {
+    if (a.startsWith("--")) {
+      const v = argv[i + 1];
+      out[a.slice(2)] = v && !v.startsWith("--") ? Number(v) : true;
+    }
+  });
+  return out;
+}
+
+function sections(md) {
+  const lines = md.split("\n");
+  const out = [];
+  let cur = null;
+  lines.forEach((l) => {
+    const m = /^##\s+(.*)$/.exec(l);
+    if (m) {
+      if (cur) out.push(cur);
+      cur = { title: m[1].trim(), body: [] };
+    } else if (cur) cur.body.push(l);
+  });
+  if (cur) out.push(cur);
+  return out;
+}
+
+function readSkill() {
+  if (!fs.existsSync(SKILL)) {
+    console.error("SKILL.md missing from this install (expected at " + SKILL + ")");
+    process.exit(2);
+  }
+  return fs.readFileSync(SKILL, "utf8");
+}
+
+const cmd = (process.argv[2] || "").toLowerCase();
+const rest = process.argv.slice(3);
+
+if (cmd === "sample") {
+  const f = flags(rest);
+  const rate = Number(f.base !== undefined ? f.base : 0.03);
+  const lift = Number(f.lift !== undefined ? f.lift : 0.2) ;
+  const power = Number(f.power !== undefined ? f.power : 0.8);
+  const alpha = Number(f.alpha !== undefined ? f.alpha : 0.05);
+  const n = sampleSize(rate, lift, power, alpha);
+  console.log(JSON.stringify({
+    baseline_rate: rate, min_relative_lift: lift, power, alpha,
+    per_arm: n, total: n * 2,
+    note: "Below this, a difference between variants is random noise. Declare this number before the test starts."
+  }, null, 2));
+} else if (cmd === "kill") {
+  const f = flags(rest);
+  const rate = Number(f.base !== undefined ? f.base : 0.03);
+  const n = Number(f.n !== undefined ? f.n : 1500);
+  const lift = Number(f.lift !== undefined ? f.lift : 0.2);
+  const floor = Math.max(0, Math.floor(rate * n - 1.2816 * Math.sqrt(n * rate * (1 - rate))));
+  const needed = sampleSize(rate, lift, 0.8, 0.05);
+  console.log(JSON.stringify({
+    baseline_rate: rate, n, min_relative_lift: lift,
+    expected_conversions: Math.round(rate * n * 10) / 10,
+    kill_floor: floor,
+    target_conversions: Math.round(rate * (1 + lift) * n * 10) / 10,
+    volume_needed_per_arm: needed,
+    verdict: n < needed
+      ? "keep running — below the required volume, a verdict now is noise"
+      : "read it — volume is sufficient; kill if conversions are at or under the floor"
+  }, null, 2));
+} else if (cmd === "sections") {
+  sections(readSkill()).forEach((s, i) => console.log(String(i + 1).padStart(2) + ". " + s.title));
+} else if (cmd === "read") {
+  const q = rest.join(" ").toLowerCase();
+  if (!q) { console.error("usage: marketing-mindset read <part of a section title>"); process.exit(1); }
+  const hit = sections(readSkill()).find((s) => s.title.toLowerCase().includes(q));
+  if (!hit) {
+    console.error("no section matches: " + q + " — run: marketing-mindset sections");
+    process.exit(1);
+  }
+  console.log("## " + hit.title + "\n" + hit.body.join("\n").trim());
+} else if (cmd === "install") {
+  require(path.join(__dirname, "install.js"));
+} else {
+  console.log(`marketing-mindset — the marketing OS for AI agents
+
+Usage:
+  npx marketing-mindset                 this help + the floors
+  npx marketing-mindset sample          required per-arm sample size
+      --base 0.03 --lift 0.2 --power 0.8 --alpha 0.05
+  npx marketing-mindset kill            kill rule for a running test
+      --base 0.03 --n 1500 --lift 0.2
+  npx marketing-mindset sections        every section of the skill
+  npx marketing-mindset read numbers    print one section
+  npx marketing-mindset install         copy the skill into your agent's skills dir
+
+Floors that do not move (see SKILL.md):
+  cold email reply-rate test   ~1,500-2,000 sends per variant
+  landing page smoke test      100-200 targeted visitors
+  strict A/B test              ~10,000 visitors per variation
+  paid ads                     spend gate 1-3x target CPA, 48-72h
+
+Docs: https://axelfreeman.github.io/marketing-mindset/
+Skill: https://github.com/axelfreeman/marketing-mindset`);
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "marketing-mindset",
-  "version": "1.0.0",
-  "description": "A marketer's operating mindset as an installable agent skill: test-size floors, kill rules, channel economics. Installs SKILL.md for Claude Code, Codex, Hermes and any agent that reads markdown skills.",
+  "version": "1.1.0",
+  "description": "A marketer's operating mindset as an installable agent skill and CLI: test-size floors, kill rules, channel economics. npx marketing-mindset sample|kill|sections|read|install.",
   "keywords": [
     "agent-skill",
     "skill",
@@ -22,7 +22,8 @@
     "url": "git+https://github.com/axelfreeman/marketing-mindset.git"
   },
   "bin": {
-    "marketing-mindset": "bin/install.js"
+    "marketing-mindset": "bin/cli.js",
+    "marketing-mindset-install": "bin/install.js"
   },
   "files": [
     "bin/",