@elmohq/cli 0.2.4 → 0.2.5

package/LICENSE.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blue Whale Software, LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -16,6 +16,7 @@
 <p align="center">
   <a href="https://www.npmjs.com/package/@elmohq/cli"><img src="https://img.shields.io/npm/v/@elmohq/cli?color=2563eb&label=npm" alt="npm version"></a>&nbsp;
   <a href="https://www.elmohq.com/docs"><img src="https://img.shields.io/badge/Docs-2563eb?style=flat&logo=readthedocs&logoColor=white" alt="Docs"></a>&nbsp;
+  <a href="https://demo.elmohq.com"><img src="https://img.shields.io/badge/Demo-22c55e?style=flat&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0ibm9uZSIgc3Ryb2tlPSJ3aGl0ZSIgc3Ryb2tlLXdpZHRoPSIyIiBzdHJva2UtbGluZWNhcD0icm91bmQiIHN0cm9rZS1saW5lam9pbj0icm91bmQiPjxwYXRoIGQ9Ik0xNSAxNGMuMi0xIC43LTEuNyAxLjUtMi41IDEtLjkgMS41LTIuMiAxLjUtMy41QTYgNiAwIDAgMCA2IDhjMCAxIC4yIDIuMiAxLjUgMy41LjcuNyAxLjMgMS41IDEuNSAyLjUiLz48cGF0aCBkPSJNOSAxOGg2Ii8+PHBhdGggZD0iTTEwIDIyaDQiLz48L3N2Zz4%3D" alt="Demo"></a>&nbsp;
   <a href="https://github.com/elmohq/elmo"><img src="https://img.shields.io/github/stars/elmohq/elmo?style=flat&logo=github&color=ee964b&label=Star" alt="GitHub stars"></a>&nbsp;
   <a href="https://discord.gg/s24nubCtKz"><img src="https://img.shields.io/badge/Discord-5865F2?style=flat&logo=discord&logoColor=white" alt="Discord"></a>
 </p>

package/dist/index.js

@@ -9,7 +9,7 @@ import * as p from "@clack/prompts";
 import { Command } from "commander";
 import pc from "picocolors";
 import semver from "semver";
-import { trackCliEvent } from "./telemetry.js";
+import { getTelemetryStatus, setTelemetryEnabled, submitNewsletterSignup, trackCliEvent } from "./telemetry.js";
 // ── Constants ────────────────────────────────────────────────────────────────
 const CONFIG_HOME = path.join(os.homedir(), ".config", "elmo");
 const CONFIG_FILE = path.join(CONFIG_HOME, "config.json");
@@ -17,6 +17,7 @@ const DEFAULT_APP_NAME = "Elmo";
 const DEFAULT_APP_ICON = "/icons/elmo-icon.svg";
 const DEFAULT_APP_URL = "http://localhost:1515";
 const LOCAL_DATABASE_URL = "postgres://postgres:postgres@postgres:5432/elmo";
+const TELEMETRY_DOC_URL = "https://elmohq.com/docs/developer-guide/telemetry";
 // ── Banner ───────────────────────────────────────────────────────────────────
 const ELMO_ASCII = [
     "",
@@ -132,8 +133,54 @@ async function main() {
         .action(async (options) => {
         await withVersionCheck(version, () => runBuild(options));
     });
+    const telemetry = program.command("telemetry").description("manage CLI + local-deployment telemetry");
+    telemetry
+        .command("status")
+        .description("show whether telemetry is enabled and what is collected")
+        .action(async () => {
+        await runTelemetryStatus();
+    });
+    telemetry
+        .command("enable")
+        .description("enable telemetry")
+        .action(async () => {
+        await setTelemetryEnabled(true);
+        const updated = await updateDeploymentEnvTelemetry(true);
+        log.success("Telemetry enabled.");
+        if (updated) {
+            log.info(`Updated ${updated}. Restart the stack with \`elmo start\` to apply.`);
+        }
+        console.log(`  Details: ${link(pc.cyan(TELEMETRY_DOC_URL), TELEMETRY_DOC_URL)}`);
+    });
+    telemetry
+        .command("disable")
+        .description("disable telemetry")
+        .action(async () => {
+        await setTelemetryEnabled(false);
+        const updated = await updateDeploymentEnvTelemetry(false);
+        log.success("Telemetry disabled. No further events will be sent.");
+        if (updated) {
+            log.info(`Updated ${updated}. Restart the stack with \`elmo start\` to apply.`);
+        }
+    });
     await program.parseAsync(process.argv);
 }
+async function runTelemetryStatus() {
+    const status = await getTelemetryStatus();
+    const state = status.enabled ? pc.green("enabled") : pc.yellow("disabled");
+    console.log(`Telemetry: ${state}`);
+    if (status.source === "env") {
+        console.log("  Source: DISABLE_TELEMETRY environment variable");
+    }
+    else if (status.source === "config") {
+        console.log(`  Source: ${CONFIG_FILE}`);
+    }
+    if (status.distinctId) {
+        console.log(`  Install ID: ${status.distinctId}`);
+    }
+    console.log(`  What we collect: ${link(pc.cyan(TELEMETRY_DOC_URL), TELEMETRY_DOC_URL)}`);
+    console.log("  Toggle: `elmo telemetry enable` / `elmo telemetry disable`");
+}
 async function withVersionCheck(version, fn) {
     const notifyPromise = maybeNotifyNewVersion(version);
     await fn();
@@ -217,6 +264,7 @@ async function runInit(options, version) {
     const env = {};
     env.DEPLOYMENT_MODE = "local";
     env.VITE_DEPLOYMENT_MODE = "local";
+    env.DEPLOYMENT_ID = crypto.randomUUID();
     env.BETTER_AUTH_SECRET = generateSecret();
     env.APP_NAME = DEFAULT_APP_NAME;
     env.APP_ICON = DEFAULT_APP_ICON;
@@ -237,7 +285,38 @@ async function runInit(options, version) {
         env.DATABASE_URL = LOCAL_DATABASE_URL;
     }
     // ── AI providers ─────────────────────────────────────────────────────
-    await configureProvidersInteractive(env);
+    const setupMode = await configureProvidersInteractive(env);
+    // ── Telemetry ───────────────────────────────────────────────────────
+    p.note([
+        "Elmo is open source and maintained by a small team. Telemetry",
+        "from both the CLI and your local deployment (web + worker)",
+        "tells us things like which CLI versions are still in use, where",
+        "`elmo init` drops off, which providers people pick, and whether",
+        "new features actually get used. Without it we are flying blind",
+        "on what to fix or build next.",
+        "",
+        pc.bold("What we send:"),
+        "  • install ID (random UUID stored in ~/.config/elmo/config.json)",
+        "  • CLI/app version, OS, arch, Node version, deployment mode",
+        "  • command/event names + non-secret options (e.g. postgres mode)",
+        "  • feature counts (prompts edited, brands created — never the names or text)",
+        "  • IP address (recorded on each event by PostHog, used for geolocation)",
+        "",
+        pc.bold("What we never send:"),
+        "  API keys, .env contents, brand names, prompt text, and scraped responses.",
+        "",
+        `Full breakdown: ${link(pc.cyan(TELEMETRY_DOC_URL), TELEMETRY_DOC_URL)}`,
+        "Toggle later with `elmo telemetry enable|disable`.",
+    ].join("\n"), "Telemetry");
+    const telemetryEnabled = await p.confirm({
+        message: "Share telemetry?",
+        initialValue: true,
+    });
+    assertNotCancelled(telemetryEnabled);
+    await setTelemetryEnabled(telemetryEnabled);
+    if (!telemetryEnabled) {
+        env.DISABLE_TELEMETRY = "1";
+    }
     // ── Product updates ─────────────────────────────────────────────────
     const updatesEmail = await p.text({
         message: "Enter your work email to receive product updates (optional)",
@@ -281,7 +360,7 @@ async function runInit(options, version) {
     else {
         p.log.info("You can start later with `elmo start`.");
     }
-    // Fire telemetry in the background — never blocks the CLI
+    // CLI telemetry — silently dropped if the user opted out above.
     await trackCliEvent("cli_init", {
         version,
         os: process.platform,
@@ -289,14 +368,22 @@ async function runInit(options, version) {
         node_version: process.version,
         postgres_mode: postgresMode,
         dev_mode: Boolean(options.dev),
-    }, email ? { $email: email, wants_updates: true } : undefined);
+        setup_mode: setupMode,
+        has_scraper: Boolean(env.BRIGHTDATA_API_TOKEN || env.OLOSTEP_API_KEY),
+        has_direct_api: hasDirectApiConfigured(env),
+    });
+    // Newsletter signup is a separate, explicit opt-in and runs even when
+    // telemetry is disabled.
+    if (email) {
+        await submitNewsletterSignup(email);
+    }
     p.log.message(`If you find Elmo useful, star us on GitHub!\n  ${link(pc.cyan("https://github.com/elmohq/elmo"), "https://github.com/elmohq/elmo")}`);
     p.outro(pc.green("Setup complete!"));
 }
 // ── Provider Configuration ───────────────────────────────────────────────────
 const BRIGHTDATA_AFFILIATE = "https://get.brightdata.com/67h1b7h0shcn";
 const OLOSTEP_AFFILIATE = "https://olostep.com/?ref=elmo";
-const PROVIDERS_DOC_URL = "https://docs.elmohq.com/docs/deployment/providers";
+const PROVIDERS_DOC_URL = "https://docs.elmohq.com/docs/user-guide/providers";
 // Surfaces each scraper can track — the first two are the "recommended starter" set.
 const BRIGHTDATA_MODELS = ["chatgpt", "google-ai-mode", "perplexity", "copilot", "gemini", "grok"];
 const OLOSTEP_MODELS = [
@@ -312,44 +399,159 @@ const DEFAULT_SCRAPER_MODELS = ["chatgpt", "google-ai-mode"];
 const DEFAULT_OPENAI_MODEL = "gpt-5-mini";
 const DEFAULT_ANTHROPIC_MODEL = "claude-sonnet-4-20250514";
 const DEFAULT_OPENROUTER_MODEL = "anthropic/claude-sonnet-4.6";
+const DEFAULT_MISTRAL_MODEL = "mistral-medium-latest";
 async function configureProvidersInteractive(env) {
     p.note([
-        "Elmo tracks which AI answer engines mention your brand. Most of",
-        "that traffic comes from ChatGPT and Google AI Mode — neither has",
-        "a public API, so tracking them requires a scraper.",
+        "Elmo needs two kinds of providers:",
+        "",
+        pc.bold("1. A scraper") + " — to track ChatGPT and Google AI Mode (no public APIs):",
+        `     • ${pc.cyan("BrightData")} — cheap solid option, ~$0.45/mo per prompt`,
+        `     • ${pc.cyan("Olostep")}    — premium option, powers Peec/AirOps, ~$2.25/mo per prompt`,
         "",
-        pc.bold("Recommended scrapers:"),
-        `  • ${pc.cyan("BrightData")} — cheap solid option, ~$0.45/mo per prompt`,
-        `  • ${pc.cyan("Olostep")}    — premium option, powers Peec/AirOps, ~$2.25/mo per prompt`,
+        pc.bold("2. A direct LLM API") + " — for low-latency tasks (onboarding analysis, sentiment scoring,",
+        "   ad-hoc LLM calls). Required:",
+        `     • ${pc.cyan("OpenRouter")} — one key, all major models (recommended)`,
+        `     • ${pc.cyan("Anthropic / OpenAI / Mistral")} — direct provider keys`,
         "",
         "Pricing assumes Elmo's default cadence (5 runs/day × 2 surfaces).",
-        "Configure any combination below — every target is opt-in.",
-    ].join("\n"), "AI visibility providers");
-    const targets = [];
-    const brightDataTookDefaults = await collectBrightData(env, targets);
-    if (brightDataTookDefaults) {
-        await finalizeScrapeTargets(env, targets, { skipEdit: true });
-        return;
+    ].join("\n"), "AI providers");
+    const mode = await p.select({
+        message: "Setup mode",
+        options: [
+            { value: "recommended", label: "Recommended — one scraper + one direct API (4 prompts)" },
+            { value: "custom", label: "Custom — pick each provider individually" },
+        ],
+        initialValue: "recommended",
+    });
+    assertNotCancelled(mode);
+    if (mode === "recommended") {
+        await configureProvidersRecommended(env);
     }
-    const olostepTookDefaults = await collectOlostep(env, targets);
-    if (olostepTookDefaults) {
-        await finalizeScrapeTargets(env, targets, { skipEdit: true });
-        return;
+    else {
+        await configureProvidersCustom(env);
     }
-    await collectAnthropic(env, targets);
-    await collectOpenAI(env, targets);
-    await collectOpenRouter(env, targets);
+    return mode;
+}
+async function configureProvidersRecommended(env) {
+    const targets = [];
+    // ── Scraper ─────────────────────────────────────────────────────────────
+    const scraper = await p.select({
+        message: "Scraper (tracks ChatGPT + Google AI Mode)",
+        options: [
+            { value: "brightdata", label: "BrightData — ~$0.45/mo per prompt (cheaper)" },
+            { value: "olostep", label: "Olostep — ~$2.25/mo per prompt (premium)" },
+        ],
+        initialValue: "brightdata",
+    });
+    assertNotCancelled(scraper);
+    await collectScraperKey(scraper, env);
+    for (const model of DEFAULT_SCRAPER_MODELS) {
+        targets.push(`${model}:${scraper}:online`);
+    }
+    // ── Direct API ──────────────────────────────────────────────────────────
+    const direct = await p.select({
+        message: "Direct LLM API (powers onboarding analysis + sentiment scoring)",
+        options: [
+            { value: "openrouter", label: "OpenRouter — one key, all major models (recommended)" },
+            { value: "anthropic", label: "Anthropic — direct Claude" },
+            { value: "openai", label: "OpenAI — direct GPT-* models" },
+            { value: "mistral", label: "Mistral — direct Mistral models" },
+        ],
+        initialValue: "openrouter",
+    });
+    assertNotCancelled(direct);
+    await collectDirectApiQuick(direct, env, targets);
+    await finalizeScrapeTargets(env, targets, { skipEdit: true });
+}
+async function configureProvidersCustom(env) {
+    const targets = [];
+    p.log.step(pc.bold("Step 1 of 2 — Direct LLM API (at least one is required)"));
+    // Order matches the auto-pick preference in onboarding/llm.ts so the first
+    // provider asked is the one onboarding will reach for by default.
+    while (!hasDirectApiConfigured(env)) {
+        await collectOpenRouter(env, targets);
+        await collectAnthropic(env, targets);
+        await collectOpenAI(env, targets);
+        await collectMistral(env, targets);
+        if (!hasDirectApiConfigured(env)) {
+            p.log.warn("Onboarding analysis and other low-latency LLM tasks require a direct API. Configure at least one before continuing.");
+        }
+    }
+    p.log.step(pc.bold("Step 2 of 2 — Scrapers (optional, but needed to track ChatGPT / Google AI Mode)"));
+    await collectBrightData(env, targets);
+    await collectOlostep(env, targets);
     await collectDataForSEO(env, targets);
     await finalizeScrapeTargets(env, targets);
 }
+function hasDirectApiConfigured(env) {
+    return Boolean(env.ANTHROPIC_API_KEY || env.OPENAI_API_KEY || env.MISTRAL_API_KEY || env.OPENROUTER_API_KEY);
+}
+async function collectScraperKey(scraper, env) {
+    if (scraper === "brightdata") {
+        p.log.info(`Sign up: ${link(pc.cyan(BRIGHTDATA_AFFILIATE), BRIGHTDATA_AFFILIATE)}`);
+        const key = await p.password({
+            message: "BrightData API token",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.BRIGHTDATA_API_TOKEN = key;
+    }
+    else {
+        p.log.info(`Sign up: ${link(pc.cyan(OLOSTEP_AFFILIATE), OLOSTEP_AFFILIATE)}`);
+        const key = await p.password({
+            message: "Olostep API key",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.OLOSTEP_API_KEY = key;
+    }
+}
+async function collectDirectApiQuick(kind, env, targets) {
+    if (kind === "openrouter") {
+        const key = await p.password({
+            message: "OpenRouter API key",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.OPENROUTER_API_KEY = key;
+        targets.push(`claude:openrouter:${DEFAULT_OPENROUTER_MODEL}:online`);
+    }
+    else if (kind === "anthropic") {
+        const key = await p.password({
+            message: "Anthropic API key",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.ANTHROPIC_API_KEY = key;
+        targets.push(`claude:anthropic-api:${DEFAULT_ANTHROPIC_MODEL}:online`);
+    }
+    else if (kind === "openai") {
+        const key = await p.password({
+            message: "OpenAI API key",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.OPENAI_API_KEY = key;
+        targets.push(`chatgpt:openai-api:${DEFAULT_OPENAI_MODEL}:online`);
+    }
+    else {
+        const key = await p.password({
+            message: "Mistral API key",
+            validate: (v) => (!v ? "Required" : undefined),
+        });
+        assertNotCancelled(key);
+        env.MISTRAL_API_KEY = key;
+        targets.push(`mistral:mistral-api:${DEFAULT_MISTRAL_MODEL}:online`);
+    }
+}
 async function collectBrightData(env, targets) {
     const enable = await p.confirm({
-        message: `Configure ${pc.bold("BrightData")}? (recommended scraper — ~$0.45/mo per prompt)`,
+        message: `Configure ${pc.bold("BrightData")}? (~$0.45/mo per prompt)`,
         initialValue: true,
     });
     assertNotCancelled(enable);
     if (!enable)
-        return false;
+        return;
     p.log.info(`Sign up and generate an API token: ${link(pc.cyan(BRIGHTDATA_AFFILIATE), BRIGHTDATA_AFFILIATE)}`);
     const key = await p.password({
         message: "BrightData API token",
@@ -357,7 +559,7 @@ async function collectBrightData(env, targets) {
     });
     assertNotCancelled(key);
     env.BRIGHTDATA_API_TOKEN = key;
-    return await pickScraperTargets({
+    await pickScraperTargets({
         providerLabel: "BrightData",
         providerId: "brightdata",
         allModels: BRIGHTDATA_MODELS,
@@ -366,12 +568,12 @@ async function collectBrightData(env, targets) {
 }
 async function collectOlostep(env, targets) {
     const enable = await p.confirm({
-        message: `Configure ${pc.bold("Olostep")}? (recommended scraper — ~$2.25/mo per prompt)`,
+        message: `Configure ${pc.bold("Olostep")}? (~$2.25/mo per prompt)`,
         initialValue: false,
     });
     assertNotCancelled(enable);
     if (!enable)
-        return false;
+        return;
     p.log.info(`Grab an API key: ${link(pc.cyan(OLOSTEP_AFFILIATE), OLOSTEP_AFFILIATE)}`);
     const key = await p.password({
         message: "Olostep API key",
@@ -379,7 +581,7 @@ async function collectOlostep(env, targets) {
     });
     assertNotCancelled(key);
     env.OLOSTEP_API_KEY = key;
-    return await pickScraperTargets({
+    await pickScraperTargets({
         providerLabel: "Olostep",
         providerId: "olostep",
         allModels: OLOSTEP_MODELS,
@@ -387,32 +589,16 @@ async function collectOlostep(env, targets) {
     });
 }
 async function pickScraperTargets(args) {
-    const { providerLabel, providerId, allModels, targets } = args;
-    const useDefault = await p.confirm({
-        message: `Track ChatGPT and Google AI Mode via ${providerLabel}? (recommended)`,
-        initialValue: true,
-    });
-    assertNotCancelled(useDefault);
-    if (useDefault) {
-        for (const model of DEFAULT_SCRAPER_MODELS) {
-            targets.push(`${model}:${providerId}:online`);
-        }
-        return true;
-    }
     const selected = (await p.multiselect({
-        message: `Pick which surfaces to track via ${providerLabel}`,
-        options: allModels.map((model) => ({
-            value: model,
-            label: model,
-        })),
+        message: `Surfaces to track via ${args.providerLabel}`,
+        options: args.allModels.map((model) => ({ value: model, label: model })),
         required: true,
         initialValues: [...DEFAULT_SCRAPER_MODELS],
     }));
     assertNotCancelled(selected);
     for (const model of selected) {
-        targets.push(`${model}:${providerId}:online`);
+        args.targets.push(`${model}:${args.providerId}:online`);
     }
-    return false;
 }
 async function collectAnthropic(env, targets) {
     const enable = await p.confirm({
@@ -470,6 +656,34 @@ async function collectOpenAI(env, targets) {
     assertNotCancelled(webSearch);
     targets.push(webSearch ? `chatgpt:openai-api:${slug}:online` : `chatgpt:openai-api:${slug}`);
 }
+async function collectMistral(env, targets) {
+    const enable = await p.confirm({
+        message: `Configure ${pc.bold("Mistral API")}? (direct Mistral models)`,
+        initialValue: false,
+    });
+    assertNotCancelled(enable);
+    if (!enable)
+        return;
+    const key = await p.password({
+        message: "Mistral API key",
+        validate: (v) => (!v ? "Required" : undefined),
+    });
+    assertNotCancelled(key);
+    env.MISTRAL_API_KEY = key;
+    const model = await p.text({
+        message: "Mistral model",
+        placeholder: DEFAULT_MISTRAL_MODEL,
+        defaultValue: DEFAULT_MISTRAL_MODEL,
+    });
+    assertNotCancelled(model);
+    const slug = model || DEFAULT_MISTRAL_MODEL;
+    const webSearch = await p.confirm({
+        message: "Enable Mistral's web search tool? (uses the beta Conversations API)",
+        initialValue: true,
+    });
+    assertNotCancelled(webSearch);
+    targets.push(webSearch ? `mistral:mistral-api:${slug}:online` : `mistral:mistral-api:${slug}`);
+}
 async function collectOpenRouter(env, targets) {
     const enable = await p.confirm({
         message: `Configure ${pc.bold("OpenRouter")}? (one key, many hosted models)`,
@@ -1068,6 +1282,23 @@ async function detectSettingsFromConfig(configDir) {
     }
     return { dev, postgresMode, repoRoot };
 }
+async function updateDeploymentEnvTelemetry(enabled) {
+    const config = await readGlobalConfig();
+    if (!config?.configDir)
+        return null;
+    const envPath = path.join(config.configDir, ".env");
+    if (!(await fileExists(envPath)))
+        return null;
+    const contents = await fs.readFile(envPath, "utf8");
+    const lines = contents.split("\n");
+    const filtered = lines.filter((line) => !/^\s*DISABLE_TELEMETRY\s*=/.test(line));
+    if (!enabled) {
+        const insertIdx = filtered.length > 0 && filtered[filtered.length - 1] === "" ? filtered.length - 1 : filtered.length;
+        filtered.splice(insertIdx, 0, "DISABLE_TELEMETRY=1");
+    }
+    await fs.writeFile(envPath, filtered.join("\n"), "utf8");
+    return envPath;
+}
 async function readEnvFile(envPath) {
     try {
         const contents = await fs.readFile(envPath, "utf8");

package/dist/telemetry.js

@@ -1,15 +1,12 @@
-import { PostHog } from "posthog-node";
+import crypto from "node:crypto";
 import fs from "node:fs/promises";
-import path from "node:path";
 import os from "node:os";
-import crypto from "node:crypto";
+import path from "node:path";
+import { PostHog } from "posthog-node";
 const POSTHOG_PUBLIC_KEY = "phc_Jhx9LnI9cTDFHpQmpOzJSDTW127qD9pFU65KRnYym6z";
 const POSTHOG_HOST = "https://us.i.posthog.com";
 const CONFIG_HOME = path.join(os.homedir(), ".config", "elmo");
 const CONFIG_FILE = path.join(CONFIG_HOME, "config.json");
-function isTelemetryDisabled() {
-    return Boolean(process.env.DISABLE_TELEMETRY);
-}
 async function readConfig() {
     try {
         const contents = await fs.readFile(CONFIG_FILE, "utf8");
@@ -23,6 +20,35 @@ async function writeConfig(config) {
     await fs.mkdir(CONFIG_HOME, { recursive: true });
     await fs.writeFile(CONFIG_FILE, JSON.stringify(config, null, 2), "utf8");
 }
+function envDisabled() {
+    return Boolean(process.env.DISABLE_TELEMETRY);
+}
+export async function isTelemetryDisabled() {
+    if (envDisabled())
+        return true;
+    const config = await readConfig();
+    return config.telemetryDisabled === true;
+}
+export async function setTelemetryEnabled(enabled) {
+    const config = await readConfig();
+    if (enabled) {
+        delete config.telemetryDisabled;
+    }
+    else {
+        config.telemetryDisabled = true;
+    }
+    await writeConfig(config);
+}
+export async function getTelemetryStatus() {
+    if (envDisabled()) {
+        return { enabled: false, source: "env" };
+    }
+    const config = await readConfig();
+    if (config.telemetryDisabled === true) {
+        return { enabled: false, source: "config", distinctId: config.telemetryId };
+    }
+    return { enabled: true, source: "default", distinctId: config.telemetryId };
+}
 async function getOrCreateDistinctId() {
     const config = await readConfig();
     if (config.telemetryId)
@@ -32,7 +58,7 @@ async function getOrCreateDistinctId() {
     return id;
 }
 export async function trackCliEvent(eventName, properties, personProperties) {
-    if (isTelemetryDisabled())
+    if (await isTelemetryDisabled())
         return;
     try {
         const distinctId = await getOrCreateDistinctId();
@@ -49,3 +75,26 @@ export async function trackCliEvent(eventName, properties, personProperties) {
         // Telemetry should never block the CLI
     }
 }
+// Newsletter signup is an explicit user action with clear intent, so it
+// fires even when anonymous telemetry is disabled. When telemetry is on the
+// event is keyed off the install UUID and the email is attached as a person
+// property — same identity as the rest of the CLI events. When telemetry is
+// off the event is keyed off the email itself, so it is never linked back
+// to the anonymous install UUID.
+export async function submitNewsletterSignup(email) {
+    try {
+        const disabled = await isTelemetryDisabled();
+        const distinctId = disabled ? email : await getOrCreateDistinctId();
+        const client = new PostHog(POSTHOG_PUBLIC_KEY, { host: POSTHOG_HOST });
+        client.capture({
+            distinctId,
+            event: "newsletter_signup",
+            properties: { source: "cli_init" },
+            ...{ $set: { $email: email, wants_updates: true } },
+        });
+        await client.shutdown();
+    }
+    catch {
+        // Newsletter signup should never block the CLI
+    }
+}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@elmohq/cli",
-  "version": "0.2.4",
+  "version": "0.2.5",
+  "license": "AGPL-3.0-or-later",
   "keywords": [
     "marketing",
     "typescript",
@@ -30,7 +31,7 @@
     "@clack/prompts": "^1.2.0",
     "commander": "^14.0.3",
     "picocolors": "^1.1.1",
-    "posthog-node": "^5.29.2",
+    "posthog-node": "^5.30.4",
     "semver": "^7.7.4"
   },
   "devDependencies": {