@vovy-ai/go 0.2.0 → 0.3.0

package/README.md

@@ -15,19 +15,20 @@ npx @vovy-ai/go uninstall    # remove everything Vovy wrote, cleanly
 
 Installed globally (`npm i -g @vovy-ai/go`), the command is just `vovy`.
 
-## Why this is free, forever
+`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.
 
-Vovy never runs its own AI model and never calls a Vovy-hosted server. It only writes markdown skill files that your existing AI coding tool reads for free, using the model you already pay for. No account, no API key, no cost, ever.
+It's MIT-licensed and runs entirely on your machine — no account, no API key, nothing phoning home.
 
 ## What it installs
 
-Three skills that make AI coding assistants safer and better-scoped for non-technical founders:
+Four skills plus a local MCP server that give AI coding assistants deterministic project context and safety rails:
 
 | Skill | What it does |
 |---|---|
 | **Prompt Rescoper** | Rewrites vague, oversized requests into a small, reviewable spec 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. |
 
 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) {
@@ -154,6 +212,7 @@ 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,8 +1,39 @@
 {
   "name": "@vovy-ai/go",
-  "version": "0.2.0",
+  "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",
+  "keywords": [
+    "vibe-coding",
+    "ai-coding-assistant",
+    "claude-code",
+    "codex-cli",
+    "cursor",
+    "cline",
+    "windsurf",
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude",
+    "llm-agent",
+    "ai-agent",
+    "coding-agent",
+    "prompt-engineering",
+    "tree-sitter",
+    "code-search",
+    "developer-tools",
+    "cli"
+  ],
   "license": "MIT",
+  "homepage": "https://github.com/Vovy-AI/vovy-cli#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Vovy-AI/vovy-cli.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/Vovy-AI/vovy-cli/issues"
+  },
+  "author": "Vovy AI",
   "type": "module",
   "bin": {
     "vovy": "./dist/index.js"
@@ -11,13 +42,14 @@
     "dist"
   ],
   "dependencies": {
-    "@vovy-ai/skills": "0.3.0",
-    "@vovy-ai/host-detect": "0.1.1"
+    "@vovy-ai/host-detect": "0.1.1",
+    "@vovy-ai/skills": "0.4.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",
-    "vitest": "^2.1.8"
+    "vitest": "^2.1.8",
+    "@vovy-ai/mcp-server": "0.3.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm --dts --clean",