@vovy-ai/go 0.3.1 → 0.4.0

package/README.md

@@ -18,7 +18,7 @@ Installed globally (`npm i -g @vovy-ai/go`), the command is just `vovy`.
 
 `npx @vovy-ai/go doctor` also reports a deterministic "always-on token footprint" — every installed skill file plus every registered MCP tool definition, the tokens a session pays whether or not any of it ever fires — and tells you which Context Engine backend your project gets: `typescript` (scope-aware, resolved through your project's own TypeScript) or `tree-sitter` (name-matching fallback), with the one-line upgrade if you're on the fallback.
 
-It's MIT-licensed and runs entirely on your machine — no account, no API key, nothing phoning home.
+It's MIT-licensed and runs entirely on your machine — no account, no API key, no background telemetry. The only network call in the CLI is a one-time, two-question install survey that sends answers **only if you type them**; skip it (or set `VOVY_NO_SURVEY=1`) and nothing is ever sent.
 
 ## What it installs
 

package/dist/index.js

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { realpathSync } from "fs";
+import { readFileSync as readFileSync3, realpathSync } from "fs";
+import { dirname as dirname2, join as join4 } from "path";
+import { createInterface } from "readline/promises";
 import { fileURLToPath } from "url";
 import { parseArgs } from "util";
 import { ADAPTERS as ADAPTERS2 } from "@vovy-ai/host-detect";
@@ -164,8 +166,109 @@ function countMemoryEntries(cwd) {
   return count;
 }
 
+// src/commands/survey.ts
+import { mkdirSync, readFileSync, writeFileSync } from "fs";
+import { dirname, join as join3 } from "path";
+var SURVEY_URL = "https://swrrttvhfnsiesmkbwia.supabase.co/rest/v1/vovy_cli_survey";
+var SURVEY_ANON_KEY = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InN3cnJ0dHZoZm5zaWVzbWtid2lhIiwicm9sZSI6ImFub24iLCJpYXQiOjE3NDQ0ODI1MjQsImV4cCI6MjA2MDA1ODUyNH0.5BMG6KY-49J_Gz8Qg02Hf3DEHgiy3evtiXqP77non_A";
+var SOURCES = [
+  { key: "1", value: "x_twitter", label: "X / Twitter" },
+  { key: "2", value: "github", label: "GitHub" },
+  { key: "3", value: "friend", label: "A friend or colleague" },
+  { key: "4", value: "search", label: "Search" },
+  { key: "5", value: "youtube", label: "YouTube" },
+  { key: "6", value: "other", label: "Other" }
+];
+function statePath(env) {
+  return join3(env.home, ".vovy", "cli-state.json");
+}
+function readState(env) {
+  try {
+    return JSON.parse(readFileSync(statePath(env), "utf8"));
+  } catch {
+    return {};
+  }
+}
+function markSurveyOffered(env) {
+  const path = statePath(env);
+  mkdirSync(dirname(path), { recursive: true });
+  writeFileSync(path, `${JSON.stringify({ ...readState(env), surveyOffered: true }, null, 2)}
+`);
+}
+function shouldOfferSurvey(env, isTty) {
+  if (!isTty) return false;
+  if (process.env.VOVY_NO_SURVEY) return false;
+  if (process.env.CI) return false;
+  if (readState(env).surveyOffered) return false;
+  return true;
+}
+function buildSurveyPayload(answers, cliVersion2) {
+  if (answers.source === void 0 && answers.rating === void 0) return null;
+  const payload = { cli_version: cliVersion2.slice(0, 20) };
+  if (answers.source !== void 0) payload.source = answers.source;
+  if (answers.source === "other" && answers.sourceOther) {
+    payload.source_other = answers.sourceOther.slice(0, 120);
+  }
+  if (answers.rating !== void 0) payload.rating = answers.rating;
+  return payload;
+}
+async function askSurveyQuestions(rl) {
+  const answers = {};
+  const sourceMenu = SOURCES.map((s) => `  [${s.key}] ${s.label}`).join("\n");
+  const sourceInput = (await rl.question(`
+How did you hear about Vovy?
+${sourceMenu}
+> `)).trim();
+  const source = SOURCES.find((s) => s.key === sourceInput);
+  if (source) {
+    answers.source = source.value;
+    if (source.value === "other") {
+      const detail = (await rl.question("Where? (optional) > ")).trim();
+      if (detail) answers.sourceOther = detail;
+    }
+  }
+  const ratingInput = (await rl.question("\nExperience so far, 1 (rough) to 5 (great)? > ")).trim();
+  const rating = Number.parseInt(ratingInput, 10);
+  if (Number.isInteger(rating) && rating >= 1 && rating <= 5) answers.rating = rating;
+  return answers;
+}
+async function sendSurvey(payload, url = SURVEY_URL) {
+  try {
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { apikey: SURVEY_ANON_KEY, "Content-Type": "application/json" },
+      body: JSON.stringify(payload),
+      signal: AbortSignal.timeout(2500)
+    });
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+async function offerSurvey(env, cliVersion2, makeInterface) {
+  markSurveyOffered(env);
+  console.log(
+    "\nOne-time question (never asked again \u2014 press Enter to skip either one).\nIf you answer, the answers and the CLI version are sent to the Vovy team; skipping sends nothing."
+  );
+  const rl = makeInterface();
+  try {
+    const answers = await askSurveyQuestions(rl);
+    const payload = buildSurveyPayload(answers, cliVersion2);
+    if (!payload) {
+      console.log("Skipped \u2014 nothing was sent.");
+      return;
+    }
+    const sent = await sendSurvey(payload);
+    console.log(
+      sent ? "Thanks \u2014 that helps more than you'd think." : "Thanks! (Couldn't reach the survey endpoint \u2014 nothing else to do.)"
+    );
+  } finally {
+    rl.close();
+  }
+}
+
 // src/commands/uninstall.ts
-import { existsSync as existsSync2, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync2, rmSync, writeFileSync as writeFileSync2 } from "fs";
 import {
   removeCodexMcpEntry,
   removeJsonMcpEntry
@@ -180,19 +283,19 @@ function runUninstall(opts) {
     const removedSkillPaths = [];
     for (const skill of SKILL_MANIFEST) {
       const path = adapter.skillFilePath(opts.env, scope, skill.id);
-      if (existsSync2(path)) {
+      if (existsSync3(path)) {
         removedSkillPaths.push(path);
         if (!dryRun) rmSync(path, { force: true });
       }
     }
     let removedMcpEntry = null;
     const mcpPath = adapter.mcpConfigPath(opts.env, scope);
-    if (mcpPath && existsSync2(mcpPath)) {
-      const existing = readFileSync(mcpPath, "utf8");
+    if (mcpPath && existsSync3(mcpPath)) {
+      const existing = readFileSync2(mcpPath, "utf8");
       const next = adapter.id === "codex" ? removeCodexMcpEntry(existing, VOVY_ID) : removeJsonMcpEntry(existing, VOVY_ID);
       if (next !== null) {
         removedMcpEntry = mcpPath;
-        if (!dryRun) writeFileSync(mcpPath, next, "utf8");
+        if (!dryRun) writeFileSync2(mcpPath, next, "utf8");
       }
     }
     return { adapter, removedSkillPaths, removedMcpEntry };
@@ -206,6 +309,14 @@ function realEnv() {
 }
 
 // src/index.ts
+function cliVersion() {
+  try {
+    const pkgPath = join4(dirname2(fileURLToPath(import.meta.url)), "..", "package.json");
+    return JSON.parse(readFileSync3(pkgPath, "utf8")).version ?? "unknown";
+  } catch {
+    return "unknown";
+  }
+}
 var HELP = `Vovy \u2014 drop-in skills for vibe coding safely with the AI tool you already use. Run via \`npx @vovy-ai/go\` (or \`vovy\` if installed globally).
 
 Usage:
@@ -251,7 +362,7 @@ function actionSymbol(action) {
   if (action === "created") return "+";
   return "~";
 }
-function cmdInstall(argv) {
+async function cmdInstall(argv) {
   const flags = parseCommonFlags(argv);
   if (flags.help) return console.log(HELP);
   const env = realEnv();
@@ -288,6 +399,13 @@ Add to ~/.claude/settings.json:
 (Faster variant: npm i -g @vovy-ai/go, then use "vovy statusline" as the command.)`
     );
   }
+  if (!flags.dryRun && shouldOfferSurvey(env, process.stdout.isTTY === true)) {
+    await offerSurvey(
+      env,
+      cliVersion(),
+      () => createInterface({ input: process.stdin, output: process.stdout })
+    );
+  }
 }
 function cmdStatusline() {
   console.log(buildStatusline(realEnv()));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vovy-ai/go",
-  "version": "0.3.1",
+  "version": "0.4.0",
   "description": "Drop-in MCP server + skill pack that teaches non-technical founders to vibe code safely — free forever. npx @vovy-ai/go install",
   "keywords": [
     "vibe-coding",