@vovy-ai/go 0.3.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @vovy-ai/go
 
-Free, forever, drop-in skills for vibe coding safely — the `vovy` CLI installer.
+The `vovy` CLI — one command drops project-aware skills, scope-aware code search, and git-committed project memory into the AI coding tool you already use. Free forever.
 
 ```
 npx @vovy-ai/go install
@@ -11,24 +11,28 @@ That's it. It detects which AI coding tool you have installed — [Claude Code](
 ```
 npx @vovy-ai/go doctor       # check everything is installed correctly
 npx @vovy-ai/go uninstall    # remove everything Vovy wrote, cleanly
+npx @vovy-ai/go statusline   # one-line badge for your tool's status bar
 ```
 
 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.
+`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
 
-Four skills plus a local MCP server that give AI coding assistants deterministic project context and safety rails:
+Five skills plus a local MCP server that give AI coding assistants deterministic project context, durable memory, and safety rails:
 
 | Skill | What it does |
 |---|---|
-| **Prompt Rescoper** | Rewrites vague, oversized requests into a small, reviewable spec before any code is written. |
+| **Prompt Rescoper** | Rewrites vague, oversized requests into a small, reviewable spec — including how the change will be verified and what imperfections are acceptable — before any code is written. |
 | **Project Skill Drafter** | Analyzes your actual project and drafts a project-specific skill so future requests already know your stack. |
 | **Founder Explainer** | Explains destructive/high-stakes actions in plain English before they happen, and flags common vibe-coding security mistakes. |
-| **Context Scoper** | Calls a tree-sitter-backed Context Engine to find the exact symbol or file before reading whole files — fewer tokens spent, fewer same-named false matches. |
+| **Context Scoper** | Finds the exact symbol, method, or file before reading whole files — via your project's own TypeScript when available (scope-aware, so two same-named functions don't get confused), tree-sitter otherwise. Includes `impact`: "what breaks if I change this", walked transitively. |
+| **Memory Keeper** | Records decisions (with what was rejected and why), mistakes (with how to avoid repeating them), and constraints (with the why) into `.vovy/memory/` — plain markdown, committed to git, so rationale survives across sessions, machines, teammates, and AI tools. |
+
+With `--scope project`, skill descriptions are tailored to your detected stack (a Next.js + TypeScript project gets descriptions that say so), which helps them trigger at the right moments at zero extra token cost.
 
 Full docs, architecture, and source: **[github.com/Vovy-AI/vovy-cli](https://github.com/Vovy-AI/vovy-cli)**
 

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,7 +309,15 @@ function realEnv() {
 }
 
 // src/index.ts
-var HELP = `Vovy \u2014 free, forever, drop-in skills for vibe coding safely. Run via \`npx @vovy-ai/go\` (or \`vovy\` if installed globally).
+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:
   npx @vovy-ai/go install [options]     Write Vovy's skills into detected (or specified) host tools
@@ -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,7 +1,7 @@
 {
   "name": "@vovy-ai/go",
-  "version": "0.3.0",
-  "description": "Free, forever, drop-in MCP server + skill pack that teaches non-technical founders to vibe code safely. npx @vovy-ai/go install",
+  "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",
     "ai-coding-assistant",
@@ -42,14 +42,14 @@
     "dist"
   ],
   "dependencies": {
-    "@vovy-ai/host-detect": "0.1.1",
-    "@vovy-ai/skills": "0.4.0"
+    "@vovy-ai/host-detect": "0.1.2",
+    "@vovy-ai/skills": "0.4.1"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
     "vitest": "^2.1.8",
-    "@vovy-ai/mcp-server": "0.3.0"
+    "@vovy-ai/mcp-server": "0.3.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",