@vovy-ai/go 0.2.1 → 0.3.1

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.
 
 ## 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

@@ -7,6 +7,8 @@ import { parseArgs } from "util";
 import { ADAPTERS as ADAPTERS2 } from "@vovy-ai/host-detect";
 
 // src/commands/doctor.ts
+import { createRequire } from "module";
+import { join } from "path";
 import { getAllSkills as getAllSkills2 } from "@vovy-ai/skills";
 
 // src/commands/install.ts
@@ -14,7 +16,7 @@ import {
   writeMcpConfig,
   writeSkillFile
 } from "@vovy-ai/host-detect";
-import { getAllSkills } from "@vovy-ai/skills";
+import { detectProjectContext, getAllSkills } from "@vovy-ai/skills";
 
 // src/targets.ts
 import { ADAPTERS, getAdapter } from "@vovy-ai/host-detect";
@@ -28,7 +30,7 @@ var VOVY_MCP_ENTRY = { id: "vovy", command: "npx", args: ["-y", "@vovy-ai/mcp-se
 function runInstall(opts) {
   const scope = opts.scope ?? "user";
   const targets = resolveTargets(opts.env, opts.hosts);
-  const skills = getAllSkills();
+  const skills = getAllSkills(scope === "project" ? detectProjectContext(opts.env.cwd) : void 0);
   return targets.map((adapter) => {
     const skillResults = skills.map((skill) => ({
       skillId: skill.id,
@@ -62,7 +64,12 @@ var MCP_TOOL_METADATA = [
   {
     name: "search_codebase",
     title: "Search Codebase",
-    description: `Deterministic, non-LLM symbol search over a JS/TS/JSX/TSX project via tree-sitter (no embeddings, no network access). Use this BEFORE reading whole files to answer a 'where is X handled' / 'how does Y work' question \u2014 it finds the exact symbol or file first so you read only what's relevant, not entire files. Actions: "overview" (top-level functions/classes/interfaces/exports in one file, needs filePath), "find_symbol" (declaration sites of a name across the project, needs query), "find_references" (identifier-boundary-aware usage sites of a name \u2014 more precise than grep since it never matches inside a string/comment, needs query), "pattern" (plain regex/text search fallback for non-code content, needs query).`
+    description: `Deterministic, non-LLM symbol search over a JS/TS/JSX/TSX project (no embeddings, no network access). Use this BEFORE reading whole files to answer a 'where is X handled' / 'what calls Y' / 'is it safe to change Z' question \u2014 it finds the exact symbol, method, or file first, so you read one function instead of one whole file. Covers class methods, interface members, and object-literal methods, not just top-level declarations. Actions: "overview" (declarations and their members in one file, needs filePath), "find_symbol" (declaration sites of a name across the project, needs query), "find_references" (usage sites of a name, excluding declarations, needs query), "impact" (transitive blast radius: who references this symbol, who references THOSE callers, and so on, depth-tagged \u2014 the 'what breaks if I change this' answer; needs query, optional maxDepth default 3), "pattern" (plain regex/text search fallback for non-code content, needs query). Every response names the \`backend\` that answered: "typescript" means results were resolved through the real type checker and each reference carries the declaration it resolves to; "tree-sitter" means results are identifier-name matches (never inside a string or comment, unlike grep) that cannot distinguish two same-named symbols in different scopes \u2014 treat those as candidates, not proof, and treat "impact" tails as over-approximate.`
+  },
+  {
+    name: "project_memory",
+    title: "Project Memory",
+    description: `Records and recalls this project's decisions, mistakes, and constraints as plain markdown under .vovy/memory/, committed to git \u2014 so rationale survives across sessions, tools, and teammates with no server or account. Actions: "record" (save an entry; needs type: "decision" | "mistake" | "constraint", title, body \u2014 for decisions include what was REJECTED and why, for mistakes include why it happened and how to avoid it, for constraints include the why behind the rule), "recall" (deterministic keyword search over saved entries; needs query \u2014 use BEFORE starting non-trivial work and before revisiting any past choice), "list" (every entry's title and type, no bodies). Never pass secrets, API keys, or passwords in a body \u2014 entries are committed to git, and record refuses content that looks like a credential.`
   }
 ];
 function estimateTokens(text) {
@@ -83,6 +90,26 @@ function computeTokenFootprint() {
     totalEstTokens: skillsEstTokens + toolsEstTokens
   };
 }
+function probeContextBackend(cwd) {
+  if (process.env.VOVY_CONTEXT_BACKEND === "tree-sitter") {
+    return {
+      backend: "tree-sitter",
+      reason: "forced by VOVY_CONTEXT_BACKEND \u2014 name-matching only, unset to restore scope-aware search"
+    };
+  }
+  try {
+    createRequire(join(cwd, "package.json")).resolve("typescript");
+    return {
+      backend: "typescript",
+      reason: "this project's own TypeScript \u2014 scope-aware, references name the declaration they resolve to"
+    };
+  } catch {
+    return {
+      backend: "tree-sitter",
+      reason: "no typescript resolvable from this project \u2014 name matches only; `npm i -D typescript` upgrades search_codebase to scope-aware results"
+    };
+  }
+}
 function runDoctor(env, hosts, scope) {
   const dryRunResults = runInstall({ env, hosts, scope, dryRun: true });
   const totalSkillCount = getAllSkills2().length;
@@ -103,11 +130,42 @@ function runDoctor(env, hosts, scope) {
       healthy: entries.length === totalSkillCount && entries.every((e) => e.status === "ok") && (mcp === null || mcp.status === "ok")
     };
   });
-  return { reports, tokenFootprint: computeTokenFootprint() };
+  return {
+    reports,
+    tokenFootprint: computeTokenFootprint(),
+    contextBackend: probeContextBackend(env.cwd)
+  };
+}
+
+// src/commands/statusline.ts
+import { existsSync, readdirSync } from "fs";
+import { join as join2 } from "path";
+function buildStatusline(env) {
+  const { reports, contextBackend } = runDoctor(env);
+  const healthy = reports.filter((r) => r.healthy).length;
+  const skills = reports.length === 0 ? "not installed" : `skills ${healthy}/${reports.length} host${reports.length === 1 ? "" : "s"} ok`;
+  const parts = [`[vovy] ${skills}`, `engine:${contextBackend.backend}`];
+  const memoryCount = countMemoryEntries(env.cwd);
+  if (memoryCount > 0) parts.push(`memory:${memoryCount}`);
+  return parts.join(" \xB7 ");
+}
+function countMemoryEntries(cwd) {
+  const memoryDir = join2(cwd, ".vovy", "memory");
+  if (!existsSync(memoryDir)) return 0;
+  let count = 0;
+  for (const typeDir of ["decisions", "mistakes", "constraints"]) {
+    const dir = join2(memoryDir, typeDir);
+    if (!existsSync(dir)) continue;
+    try {
+      count += readdirSync(dir).filter((f) => f.endsWith(".md")).length;
+    } catch {
+    }
+  }
+  return count;
 }
 
 // src/commands/uninstall.ts
-import { existsSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync as existsSync2, readFileSync, rmSync, writeFileSync } from "fs";
 import {
   removeCodexMcpEntry,
   removeJsonMcpEntry
@@ -122,14 +180,14 @@ function runUninstall(opts) {
     const removedSkillPaths = [];
     for (const skill of SKILL_MANIFEST) {
       const path = adapter.skillFilePath(opts.env, scope, skill.id);
-      if (existsSync(path)) {
+      if (existsSync2(path)) {
         removedSkillPaths.push(path);
         if (!dryRun) rmSync(path, { force: true });
       }
     }
     let removedMcpEntry = null;
     const mcpPath = adapter.mcpConfigPath(opts.env, scope);
-    if (mcpPath && existsSync(mcpPath)) {
+    if (mcpPath && existsSync2(mcpPath)) {
       const existing = readFileSync(mcpPath, "utf8");
       const next = adapter.id === "codex" ? removeCodexMcpEntry(existing, VOVY_ID) : removeJsonMcpEntry(existing, VOVY_ID);
       if (next !== null) {
@@ -148,12 +206,13 @@ 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).
+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
   npx @vovy-ai/go doctor [options]      Check whether Vovy is correctly installed, without changing anything
   npx @vovy-ai/go uninstall [options]   Remove everything Vovy's installer wrote
+  npx @vovy-ai/go statusline            One-line status for a host's status bar (engine, skills, memory)
 
 Options:
   --host <ids>       Comma-separated host ids to target instead of auto-detecting.
@@ -220,12 +279,24 @@ ${adapter.label}:`);
   console.log(
     flags.dryRun ? "\nDry run only \u2014 nothing was written. Re-run without --dry-run to apply." : "\nDone. Vovy's skills are now available in your tool(s) above."
   );
+  if (!flags.dryRun && reports.some((r) => r.adapter.id === "claude-code")) {
+    console.log(
+      `
+Optional: a Vovy status-bar badge for Claude Code (shows engine + memory at a glance).
+Add to ~/.claude/settings.json:
+  "statusLine": { "type": "command", "command": "npx -y @vovy-ai/go statusline" }
+(Faster variant: npm i -g @vovy-ai/go, then use "vovy statusline" as the command.)`
+    );
+  }
+}
+function cmdStatusline() {
+  console.log(buildStatusline(realEnv()));
 }
 function cmdDoctor(argv) {
   const flags = parseCommonFlags(argv);
   if (flags.help) return console.log(HELP);
   const env = realEnv();
-  const { reports, tokenFootprint } = runDoctor(env, flags.hosts, flags.scope);
+  const { reports, tokenFootprint, contextBackend } = runDoctor(env, flags.hosts, flags.scope);
   if (reports.length === 0) {
     console.log("No supported host tools detected on this machine \u2014 nothing to check.");
     return;
@@ -244,6 +315,10 @@ ${adapter.label}: ${healthy ? "OK" : "needs `npx @vovy-ai/go install`"}`);
   }
   console.log(
     `
+search_codebase backend for this directory: ${contextBackend.backend} (${contextBackend.reason})`
+  );
+  console.log(
+    `
 Estimated always-on token footprint: ~${tokenFootprint.totalEstTokens} tokens (${tokenFootprint.skillCount} skill files ~${tokenFootprint.skillsEstTokens}, ${tokenFootprint.toolCount} MCP tool definitions ~${tokenFootprint.toolsEstTokens}) \u2014 what every session pays whether or not a skill fires. chars/4 estimate, not an exact tokenizer count.`
   );
   process.exitCode = allHealthy ? 0 : 1;
@@ -284,6 +359,8 @@ async function main() {
       return cmdDoctor(rest);
     case "uninstall":
       return cmdUninstall(rest);
+    case "statusline":
+      return cmdStatusline();
     case "--help":
     case "-h":
     case void 0:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@vovy-ai/go",
-  "version": "0.2.1",
-  "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.3.1",
+  "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,13 +42,14 @@
     "dist"
   ],
   "dependencies": {
-    "@vovy-ai/host-detect": "0.1.1",
-    "@vovy-ai/skills": "0.3.1"
+    "@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"
+    "vitest": "^2.1.8",
+    "@vovy-ai/mcp-server": "0.3.1"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",