@agentsean/launch 1.0.0

package/dist/recipes.js

@@ -0,0 +1,225 @@
+export const RECIPES = [
+    {
+        id: "fix-title-tags-wordpress",
+        title: "Fix title tags on WordPress",
+        summary: "Sean writes unique titles through the companion plugin, verifies live HTML, and stores a revert snapshot.",
+        cms: ["wordpress"],
+        href: "/recipes/fix-title-tags-wordpress.html",
+        steps: [
+            "Install sean-bridge and create an Application Password.",
+            "sean connect wordpress --api-key USER:APP_PASSWORD https://example.com",
+            "sean apply — T1 title-tag Actions apply automatically after the observe window.",
+            "Click Revert on any change. The shadow ledger restores the previous post meta.",
+        ],
+    },
+    {
+        id: "fix-orphaned-pages-shopify",
+        title: "Fix orphaned pages on a Shopify store",
+        summary: "Internal-link Actions go to metafields. Theme writes are refused — Shopify write_themes stays denied.",
+        cms: ["shopify"],
+        href: "/recipes/fix-orphaned-pages-shopify.html",
+        steps: [
+            "sean connect shopify --api-key shpat_… mystore.myshopify.com",
+            "Sean lists pages with zero inbound links from the crawl graph.",
+            "An Action proposes a metafield + a merchant-pasted snippet. Sean never writes the theme.",
+            "Verify-by-refetch. Revert restores the previous metafield value.",
+        ],
+    },
+    {
+        id: "git-pr-title-tags-nextjs",
+        title: "Open a Git PR for Next.js title tags",
+        summary: "The git adapter writes a reviewable diff against the customer's source of truth.",
+        cms: ["git"],
+        href: "/recipes/git-pr-title-tags-nextjs.html",
+        steps: [
+            "sean apply --repo ./my-next-app",
+            "Sean plans title-tag Actions, runs the 15-check validator, opens a PR.",
+            "Merge is yours. Revert is another PR from the shadow-ledger snapshot.",
+        ],
+    },
+    {
+        id: "refresh-decaying-content",
+        title: "Refresh a decaying page",
+        summary: "Daily, Sean picks a page whose GSC clicks are falling, rewrites it, runs PublishGate, and publishes. 2 refreshes/day, not overridable.",
+        cms: ["wordpress", "git", "shopify"],
+        href: "/recipes/refresh-decaying-content.html",
+        steps: [
+            "Connect Google so clicks exist. Default metric is clicks.",
+            "sean content — or wait for the daily job.",
+            "PublishGate refuses YMYL, affiliate, and thin rewrites.",
+            "newPagesPerDay=2 and contentRefreshPerDay=2 cannot be raised.",
+        ],
+    },
+    {
+        id: "faq-schema-from-gsc",
+        title: "FAQ schema from Search Console queries",
+        summary: "Schema is a check, not an AEO lever. Sean will not sell llms.txt, word count, or FAQ schema as AI-citation tactics.",
+        cms: ["wordpress", "git"],
+        href: "/recipes/faq-schema-from-gsc.html",
+        steps: [
+            "Pull GSC queries for a URL.",
+            "If the page already answers them, Sean may add FAQPage JSON-LD.",
+            "If it does not, Sean refreshes the copy first. Schema without the answer is refused.",
+        ],
+    },
+    {
+        id: "internal-links-pillar",
+        title: "Build internal links into a pillar page",
+        summary: "Deterministic graph, not an LLM with write credentials.",
+        cms: ["wordpress", "git", "shopify"],
+        href: "/recipes/internal-links-pillar.html",
+        steps: [
+            "Crawl produces the link graph.",
+            "Sean queues T2 internal-link Actions onto relevant pages.",
+            "Each apply is verified by re-fetching live HTML.",
+        ],
+    },
+    {
+        id: "gbp-local-pack",
+        title: "Keep a Google Business Profile inside quota",
+        summary: "10 edits/min, 300 QPM, and 0 QPM until the location is approved. Sean will not generate reviews (T4).",
+        cms: ["other"],
+        href: "/recipes/gbp-local-pack.html",
+        steps: [
+            "sean local — detect the GBP and the quota remaining.",
+            "Safe edits (hours, categories) apply; review generation is refused.",
+            "City×service pages are T4 and are not created unbounded.",
+        ],
+    },
+    {
+        id: "ai-citation-share",
+        title: "Measure AI citation share",
+        summary: "~$1.11/run across ~20 prompts × 2 engines. Training crawlers ≠ citation crawlers. Schema and llms.txt are not sold as levers.",
+        cms: ["other"],
+        href: "/recipes/ai-citation-share.html",
+        steps: [
+            "sean visibility",
+            "Bing Webmaster AI CSV is import-only — there is no API.",
+            "robots.txt is checked for accidental training-crawler blocks vs citation-crawler blocks.",
+        ],
+    },
+    {
+        id: "brand-mentions-outreach",
+        title: "Mention-first outreach",
+        summary: "Find unlinked brand mentions. Sending email is T3 two-key. Sean does not buy links.",
+        cms: ["other"],
+        href: "/recipes/brand-mentions-outreach.html",
+        steps: [
+            "sean mentions",
+            "Review the draft. Two-key send is not overridable.",
+            "T4 review generation and paid placements are refused.",
+        ],
+    },
+    {
+        id: "cloudflare-edge-squarespace",
+        title: "Edge overlay for Squarespace / Framer / Duda",
+        summary: "The worker never branches on user-agent. That is the cloaking line.",
+        cms: ["cloudflare"],
+        href: "/recipes/cloudflare-edge-squarespace.html",
+        steps: [
+            "sean connect cloudflare",
+            "Title-tag overlays apply to HTML for every client.",
+            "A crawler-only branch is a bug. Tests assert one response.",
+        ],
+    },
+    {
+        id: "revert-a-change",
+        title: "Revert a live change",
+        summary: "Every write has a before-snapshot. One click, or sean revert <id>.",
+        cms: ["wordpress", "shopify", "git", "cloudflare"],
+        href: "/recipes/revert-a-change.html",
+        steps: [
+            "Open Activity. Every applied Action has Revert.",
+            "sean revert <changeId>",
+            "Verify-by-refetch confirms the old HTML is back.",
+        ],
+    },
+    {
+        id: "freeze-writes",
+        title: "Freeze every write",
+        summary: "sean freeze writes HALT and survives restart. The kill switch is the product.",
+        cms: ["other"],
+        href: "/recipes/freeze-writes.html",
+        steps: [
+            "sean freeze",
+            "Confirm the dashboard banner.",
+            "sean unfreeze when ready.",
+        ],
+    },
+    {
+        id: "observe-then-apply",
+        title: "Observe, then apply",
+        summary: "7-day observe-only on a new site, shortenable to 24h, not to zero.",
+        cms: ["other"],
+        href: "/recipes/observe-then-apply.html",
+        steps: [
+            "Onboard a site. Auto-apply waits out observeUntil.",
+            "Settings will not accept observeDays: 0.",
+            "T3 still needs two keys after the window.",
+        ],
+    },
+    {
+        id: "bing-volume-no-paid-key",
+        title: "Keyword volume with zero paid keys",
+        summary: "GSC + Bing + autocomplete. Sean never scrapes Google.",
+        cms: ["other"],
+        href: "/recipes/bing-volume-no-paid-key.html",
+        steps: [
+            "sean keywords",
+            "DataForSEO is an upgrade for rank tracking, not a requirement.",
+            "Default metric is clicks. Impressions 2025-05-13 to 2026-04-27 are contaminated.",
+        ],
+    },
+    {
+        id: "evidence-tier-report",
+        title: "Report with an evidence tier",
+        summary: "Causation only at tier A. Small sites mostly land in E — applied, not measurable.",
+        cms: ["other"],
+        href: "/recipes/evidence-tier-report.html",
+        steps: [
+            "sean measure",
+            "Every claim carries A–E.",
+            "Sean will not claim a ranking lift it cannot support.",
+        ],
+    },
+    {
+        id: "connect-google-byo",
+        title: "Bring your own Google Cloud project",
+        summary: "The hosted broker never talks to this machine. --byo publishes to Production on your project.",
+        cms: ["other"],
+        href: "/recipes/connect-google-byo.html",
+        steps: [
+            "sean connect google --byo --credentials ./client_secret.json",
+            "The dashboard at 127.0.0.1:7777/connect runs the loopback OAuth dance.",
+            "Sensitive-scope, not CASA.",
+        ],
+    },
+    {
+        id: "agency-ten-sites",
+        title: "Run ten client sites on Agency",
+        summary: "Cloud Agency is $249/mo for 25–50 sites. Hosted never stores CMS write credentials.",
+        cms: ["other"],
+        href: "/recipes/agency-ten-sites.html",
+        steps: [
+            "sean signup agency",
+            "Pair a customer-side connector per site.",
+            "sean tenant — per-tenant cost visibility.",
+        ],
+    },
+    {
+        id: "city-service-pages-refused",
+        title: "City × service pages are refused",
+        summary: "Unbounded location pages are T4. The honest recipe is: do not do this.",
+        cms: ["other"],
+        href: "/recipes/city-service-pages-refused.html",
+        steps: [
+            "A request to create_city_service_page is refused.",
+            "Use GBP + a handful of real location pages you will maintain.",
+            "Scaled location spam is how sites earn a manual action.",
+        ],
+    },
+];
+export function recipeById(id) {
+    return RECIPES.find((r) => r.id === id);
+}
+//# sourceMappingURL=recipes.js.map

package/dist/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../src/recipes.ts"],"names":[],"mappings":"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"}

package/dist/service.d.ts

@@ -0,0 +1,22 @@
+export type ServiceKind = "systemd-user" | "launchd" | "schtasks";
+export declare function serviceKind(platform?: string): ServiceKind;
+export type ServicePlan = {
+    kind: ServiceKind;
+    path: string;
+    contents: string;
+    enable: string[];
+    disable: string[];
+    summary: string;
+};
+export type ServicePlanInput = {
+    home: string;
+    nodePath: string;
+    daemonEntry: string;
+    host?: string | undefined;
+    port?: number | undefined;
+    platform?: string | undefined;
+};
+export declare function planService(input: ServicePlanInput): ServicePlan;
+export declare function writeService(plan: ServicePlan): void;
+export declare function removeServiceFile(plan: ServicePlan): void;
+//# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,WAAW,GAAG,cAAc,GAAG,SAAS,GAAG,UAAU,CAAC;AAElE,wBAAgB,WAAW,CAAC,QAAQ,GAAE,MAAyB,GAAG,WAAW,CAI5E;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,WAAW,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,CAAC;AAEF,wBAAgB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,WAAW,CAoGhE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAGpD;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,CAEzD"}

package/dist/service.js

@@ -0,0 +1,127 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+export function serviceKind(platform = process.platform) {
+    if (platform === "darwin")
+        return "launchd";
+    if (platform === "win32")
+        return "schtasks";
+    return "systemd-user";
+}
+export function planService(input) {
+    const host = input.host ?? "127.0.0.1";
+    const port = input.port ?? 7777;
+    if (host !== "127.0.0.1" && host !== "localhost" && host !== "::1") {
+        throw new Error(`Refusing to install a service that binds ${host}. The user unit is loopback-only. Use Tailscale Serve for remote access.`);
+    }
+    const kind = serviceKind(input.platform ?? process.platform);
+    const nodePath = input.nodePath;
+    const entry = input.daemonEntry;
+    const home = input.home;
+    if (kind === "launchd") {
+        const plist = path.join(os.homedir(), "Library/LaunchAgents/dev.agentsean.plist");
+        const contents = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>dev.agentsean</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${escapeXml(nodePath)}</string>
+    <string>${escapeXml(entry)}</string>
+    <string>--host</string><string>127.0.0.1</string>
+    <string>--port</string><string>${port}</string>
+    <string>--home</string><string>${escapeXml(home)}</string>
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>SEAN_HOME</key><string>${escapeXml(home)}</string>
+  </dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>StandardOutPath</key><string>${escapeXml(path.join(home, "daemon.log"))}</string>
+  <key>StandardErrorPath</key><string>${escapeXml(path.join(home, "daemon.log"))}</string>
+</dict>
+</plist>
+`;
+        return {
+            kind,
+            path: plist,
+            contents,
+            enable: ["launchctl", "load", plist],
+            disable: ["launchctl", "unload", plist],
+            summary: `macOS LaunchAgent\n  write ${plist}\n  launchctl load ${plist}\n  bind 127.0.0.1:${port}\n  SEAN_HOME=${home}`,
+        };
+    }
+    if (kind === "schtasks") {
+        const xmlPath = path.join(home, "agentsean.schtasks.xml");
+        const tr = `"${nodePath}" "${entry}" --host 127.0.0.1 --port ${port} --home "${home}"`;
+        const contents = `<?xml version="1.0" encoding="UTF-16"?>
+<Task version="1.2" xmlns="http://schemas.microsoft.com/windows/2004/02/mit/task">
+  <RegistrationInfo><Description>Agent Sean</Description></RegistrationInfo>
+  <Triggers><LogonTrigger><Enabled>true</Enabled></LogonTrigger></Triggers>
+  <Actions Context="Author">
+    <Exec>
+      <Command>${escapeXml(nodePath)}</Command>
+      <Arguments>${escapeXml(`"${entry}" --host 127.0.0.1 --port ${port} --home "${home}"`)}</Arguments>
+    </Exec>
+  </Actions>
+  <Settings><MultipleInstancesPolicy>IgnoreNew</MultipleInstancesPolicy></Settings>
+</Task>
+`;
+        return {
+            kind,
+            path: xmlPath,
+            contents,
+            enable: ["schtasks", "/Create", "/TN", "AgentSean", "/XML", xmlPath, "/F"],
+            disable: ["schtasks", "/Delete", "/TN", "AgentSean", "/F"],
+            summary: `Windows Scheduled Task\n  write ${xmlPath}\n  schtasks /Create /TN AgentSean /XML ${xmlPath}\n  start at logon: ${tr}\n  bind 127.0.0.1:${port}`,
+        };
+    }
+    const unitDir = path.join(os.homedir(), ".config/systemd/user");
+    const unit = path.join(unitDir, "agentsean.service");
+    const contents = `[Unit]
+Description=Agent Sean — the SEO engineer that never sleeps
+After=network.target
+
+[Service]
+Type=simple
+ExecStart=${shellQuote(nodePath)} ${shellQuote(entry)} --host 127.0.0.1 --port ${port} --home ${shellQuote(home)}
+Restart=on-failure
+RestartSec=5
+Environment=SEAN_HOME=${home}
+WorkingDirectory=${home}
+
+[Install]
+WantedBy=default.target
+`;
+    return {
+        kind,
+        path: unit,
+        contents,
+        enable: ["systemctl", "--user", "enable", "--now", "agentsean.service"],
+        disable: ["systemctl", "--user", "disable", "--now", "agentsean.service"],
+        summary: `Linux systemd user unit\n  write ${unit}\n  systemctl --user enable --now agentsean.service\n  bind 127.0.0.1:${port}\n  SEAN_HOME=${home}`,
+    };
+}
+export function writeService(plan) {
+    fs.mkdirSync(path.dirname(plan.path), { recursive: true, mode: 0o755 });
+    fs.writeFileSync(plan.path, plan.contents, { mode: 0o644 });
+}
+export function removeServiceFile(plan) {
+    if (fs.existsSync(plan.path))
+        fs.unlinkSync(plan.path);
+}
+function escapeXml(s) {
+    return s
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+function shellQuote(s) {
+    if (/^[A-Za-z0-9_./:-]+$/.test(s))
+        return s;
+    return `'${s.replaceAll("'", `'\\''`)}'`;
+}
+//# sourceMappingURL=service.js.map

package/dist/service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.js","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"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"}

package/dist/site.d.ts

@@ -0,0 +1,9 @@
+import { type Recipe } from "./recipes.js";
+import { VERSION } from "./version.js";
+export declare const POSITIONING = "Every SEO tool tells you what's wrong. Agent Sean fixes it.";
+export declare const OPENSEO_CREDIT = "OpenSEO proved an open-source SEO platform could work. Agent Sean is the execution layer that writes reversible diffs to your actual site \u2014 not a fork of OpenSEO, and not a report that stops at the finding.";
+export declare function recipePage(recipe: Recipe): string;
+export declare function recipesIndex(): string;
+export declare function escapeHtml(s: string): string;
+export { VERSION };
+//# sourceMappingURL=site.d.ts.map

package/dist/site.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.d.ts","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,eAAO,MAAM,WAAW,gEACuC,CAAC;AAEhE,eAAO,MAAM,cAAc,wNACuL,CAAC;AAEnN,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA8BjD;AAED,wBAAgB,YAAY,IAAI,MAAM,CA8BrC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAM5C;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/site.js

@@ -0,0 +1,72 @@
+import { RECIPES } from "./recipes.js";
+import { VERSION } from "./version.js";
+export const POSITIONING = "Every SEO tool tells you what's wrong. Agent Sean fixes it.";
+export const OPENSEO_CREDIT = "OpenSEO proved an open-source SEO platform could work. Agent Sean is the execution layer that writes reversible diffs to your actual site — not a fork of OpenSEO, and not a report that stops at the finding.";
+export function recipePage(recipe) {
+    const steps = recipe.steps.map((s) => `<li>${escapeHtml(s)}</li>`).join("\n");
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8"/>
+  <title>${escapeHtml(recipe.title)} — Agent Sean</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <meta name="description" content="${escapeHtml(recipe.summary)}"/>
+  <link rel="stylesheet" href="../assets/style.css"/>
+</head>
+<body>
+  <header>
+    <a href="../index.html">Agent Sean</a>
+    <nav>
+      <a href="../install.html">Install</a>
+      <a href="index.html">Recipes</a>
+      <a href="../security.html">Security</a>
+    </nav>
+  </header>
+  <main>
+    <p class="kicker">${recipe.cms.join(" · ")}</p>
+    <h1>${escapeHtml(recipe.title)}</h1>
+    <p class="lead">${escapeHtml(recipe.summary)}</p>
+    <ol>${steps}</ol>
+    <p><a href="index.html">All recipes</a></p>
+  </main>
+</body>
+</html>
+`;
+}
+export function recipesIndex() {
+    const items = RECIPES.map((r) => `<li id="${escapeHtml(r.id)}"><a href="${escapeHtml(r.id)}.html">${escapeHtml(r.title)}</a> — ${escapeHtml(r.summary)}</li>`).join("\n");
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8"/>
+  <title>SEO recipes — Agent Sean</title>
+  <meta name="viewport" content="width=device-width, initial-scale=1"/>
+  <link rel="stylesheet" href="../assets/style.css"/>
+</head>
+<body>
+  <header>
+    <a href="../index.html">Agent Sean</a>
+    <nav>
+      <a href="../install.html">Install</a>
+      <a href="index.html">Recipes</a>
+      <a href="../security.html">Security</a>
+    </nav>
+  </header>
+  <main>
+    <h1>Recipes</h1>
+    <p class="lead">First-party, reviewed by us. Not an open marketplace — plugins with write access to live sites do not get a public upload form.</p>
+    <ul class="recipes">${items}</ul>
+  </main>
+</body>
+</html>
+`;
+}
+export function escapeHtml(s) {
+    return s
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;");
+}
+export { VERSION };
+//# sourceMappingURL=site.js.map

package/dist/site.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site.js","sourceRoot":"","sources":["../src/site.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAe,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,CAAC,MAAM,WAAW,GACtB,6DAA6D,CAAC;AAEhE,MAAM,CAAC,MAAM,cAAc,GACzB,gNAAgN,CAAC;AAEnN,MAAM,UAAU,UAAU,CAAC,MAAc;IACvC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9E,OAAO;;;;WAIE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;;sCAEG,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;;;;;;;;;;;;;wBAaxC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;UACpC,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;sBACZ,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC;UACtC,KAAK;;;;;CAKd,CAAC;AACF,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CACvB,CAAC,CAAC,EAAE,EAAE,CACJ,WAAW,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,cAAc,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAC/H,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACb,OAAO;;;;;;;;;;;;;;;;;;;;0BAoBiB,KAAK;;;;CAI9B,CAAC;AACF,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,CAAS;IAClC,OAAO,CAAC;SACL,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC;SACxB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,MAAM,CAAC;SACvB,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,OAAO,EAAE,OAAO,EAAE,CAAC"}

package/dist/telemetry.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Event names. The only fields we ever send are in `TelemetryPayload`.
+ * Never: domain, URL, page content, GSC query, API key, IP, hostname.
+ */
+export declare const TELEMETRY_EVENTS: readonly ["first_run", "command_used", "feature_used", "error_class", "cms_type", "service_installed"];
+export type TelemetryEventName = (typeof TELEMETRY_EVENTS)[number];
+export type TelemetryPayload = {
+    event: TelemetryEventName;
+    version: string;
+    os: string;
+    arch: string;
+    node: string;
+    installMethod: string;
+    cmsType: string | null;
+    command: string | null;
+    feature: string | null;
+    errorClass: string | null;
+};
+export type TelemetryConfig = {
+    enabled: boolean;
+    consentedAt: string | null;
+    installMethod: string;
+};
+export declare function telemetryPath(home: string): string;
+export declare function telemetryLogPath(home: string): string;
+export declare function dntHonored(env?: NodeJS.ProcessEnv): boolean;
+export declare function defaultConfig(installMethod?: string): TelemetryConfig;
+export declare function loadTelemetryConfig(home: string): TelemetryConfig;
+export declare function saveTelemetryConfig(home: string, config: TelemetryConfig): void;
+export declare function isTelemetryEnabled(home: string, env?: NodeJS.ProcessEnv): boolean;
+export declare function previewPayload(partial?: Partial<TelemetryPayload>): TelemetryPayload;
+export declare function assertSafePayload(payload: TelemetryPayload): void;
+export declare function recordEvent(home: string, partial: Partial<TelemetryPayload> & {
+    event: TelemetryEventName;
+}, env?: NodeJS.ProcessEnv): TelemetryPayload | null;
+export declare function readTelemetryLog(home: string): TelemetryPayload[];
+export declare function consentTelemetry(home: string, enabled: boolean, installMethod: string): TelemetryConfig;
+//# sourceMappingURL=telemetry.d.ts.map

package/dist/telemetry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telemetry.d.ts","sourceRoot":"","sources":["../src/telemetry.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,wGAOnB,CAAC;AAEX,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAkBF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAElD;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,UAAU,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAMxE;AAED,wBAAgB,aAAa,CAAC,aAAa,SAAQ,GAAG,eAAe,CAEpE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,CAajE;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAK/E;AAED,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,OAAO,CAGT;AAED,wBAAgB,cAAc,CAC5B,OAAO,GAAE,OAAO,CAAC,gBAAgB,CAAM,GACtC,gBAAgB,CAelB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAWjE;AAED,wBAAgB,WAAW,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAAG;IAAE,KAAK,EAAE,kBAAkB,CAAA;CAAE,EAClE,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,gBAAgB,GAAG,IAAI,CAoBzB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,EAAE,CAQjE;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,aAAa,EAAE,MAAM,GACpB,eAAe,CAQjB"}