@vera-ai/cli 0.3.1 → 0.4.1

package/README.md

@@ -4,34 +4,54 @@ Code search for AI agents. Vera indexes your codebase using tree-sitter parsing
 
 This package downloads and wraps the native Vera binary for your platform.
 
+Current benchmark snapshot: on Vera's local 21-task, 4-repo release benchmark, `v0.7.0` reaches `0.78` Recall@5, `0.83` Recall@10, `0.91` MRR@10, and `0.84` nDCG@10 with the local Jina CUDA ONNX stack. Full details live in the main repo docs.
+
 ## Install
 
 ```bash
 npm install -g @vera-ai/cli
 ```
 
+`vera setup` with no flags runs an interactive wizard (backend + agent skills + optional indexing). For focused changes: `vera backend` manages the ONNX runtime, `vera agent install` manages skill files and can update `AGENTS.md` / `CLAUDE.md` style project instructions, and `vera agent sync` refreshes stale skills after upgrades.
+
 ## Usage
 
 ```bash
+# Optional: install skill files for your agents
+vera agent install
+
 # Index a project
 vera index .
 
 # Search
 vera search "authentication middleware"
 
-# Local ONNX inference (no API keys needed — downloads models automatically)
+# Local ONNX inference (no API keys needed. downloads models automatically)
 vera index . --onnx-jina-cpu
 vera search "error handling" --onnx-jina-cpu
 
-# GPU acceleration (NVIDIA/AMD/DirectML)
+# Optional local CodeRankEmbed preset
+vera setup --code-rank-embed --onnx-jina-cuda
+
+# GPU acceleration (NVIDIA/AMD/DirectML/CoreML/OpenVINO)
 vera index . --onnx-jina-cuda
+
+# Diagnose or repair local setup issues
+vera doctor
+vera doctor --probe
+vera repair
+vera upgrade
 ```
 
+`vera doctor --probe` runs a deeper read-only ONNX session check. `vera upgrade` shows the binary update plan and can apply it when the install method is known.
+
+On GPU backends, Vera uses a free-VRAM-aware batch ceiling and sequence-aware local micro-batching, and it reuses learned device-specific batch windows across runs.
+
 ## What you get
 
 - **60+ languages** via tree-sitter AST parsing
 - **Hybrid search**: BM25 keyword + vector similarity, fused with Reciprocal Rank Fusion
 - **Cross-encoder reranking** for precision
-- **JSON output** with file paths, line ranges, code content, and relevance scores
+- **Markdown codeblock output** by default with file paths, line ranges, and optional symbol info (use `--json` for compact JSON, `--raw` for verbose output, `--timing` for step durations)
 
-For full documentation, see the [GitHub repo](https://github.com/lemon07r/Vera).
+For full documentation, including custom local ONNX embedding models and manual install steps, see the [GitHub repo](https://github.com/lemon07r/Vera).

package/bin/vera.js

@@ -62,6 +62,42 @@ function defaultVeraHome() {
   return process.env.VERA_HOME || path.join(os.homedir(), ".vera");
 }
 
+function installMetadataPath() {
+  return path.join(defaultVeraHome(), "install.json");
+}
+
+function currentInstallMethod() {
+  if (process.versions.bun) return "bun";
+  const ua = process.env.npm_config_user_agent || "";
+  if (ua.startsWith("bun/")) return "bun";
+  const execpath = process.env.npm_execpath || "";
+  if (execpath.includes("bun")) return "bun";
+  return "npm";
+}
+
+async function readInstallMetadata() {
+  try {
+    const raw = await fsp.readFile(installMetadataPath(), "utf8");
+    return JSON.parse(raw);
+  } catch {
+    return {};
+  }
+}
+
+async function writeInstallMetadata({ installMethod, version, binaryPath }) {
+  const metadataPath = installMetadataPath();
+  await fsp.mkdir(path.dirname(metadataPath), { recursive: true });
+  const current = await readInstallMetadata();
+  const next = {
+    install_method: installMethod ?? current.install_method ?? null,
+    version: version ?? current.version ?? null,
+    binary_path: binaryPath ?? current.binary_path ?? null,
+  };
+  const tmpPath = `${metadataPath}.tmp.${process.pid}`;
+  await fsp.writeFile(tmpPath, `${JSON.stringify(next, null, 2)}\n`, "utf8");
+  await fsp.rename(tmpPath, metadataPath);
+}
+
 function preferredBinDirs() {
   const home = os.homedir();
   if (process.env.VERA_USER_BIN_DIR) {
@@ -198,7 +234,7 @@ async function extractArchive(archivePath, destination) {
     runChecked("powershell", [
       "-NoProfile",
       "-Command",
-      "Expand-Archive",
+      "Import-Module Microsoft.PowerShell.Archive; Expand-Archive",
       "-LiteralPath",
       archivePath,
       "-DestinationPath",
@@ -260,6 +296,11 @@ async function ensureBinaryInstalled() {
   const binaryPath = path.join(installDir, binaryName());
   if (fs.existsSync(binaryPath)) {
     await createShim(binaryPath);
+    await writeInstallMetadata({
+      installMethod: currentInstallMethod(),
+      version,
+      binaryPath,
+    });
     return { binaryPath, version };
   }
 
@@ -289,6 +330,11 @@ async function ensureBinaryInstalled() {
       console.error(`Added Vera to ${path.dirname(shimPath)}. Add that directory to PATH to run \`vera\` directly.`);
     }
 
+    await writeInstallMetadata({
+      installMethod: currentInstallMethod(),
+      version,
+      binaryPath,
+    });
     return { binaryPath, version };
   } finally {
     await fsp.rm(tempRoot, { recursive: true, force: true });
@@ -305,6 +351,16 @@ function runBinary(binaryPath, args) {
 
 async function main() {
   const { command, rest } = parseArgs(process.argv.slice(2));
+
+  if (command === "_record-install-method") {
+    await writeInstallMetadata({
+      installMethod: "npm",
+      version: packageVersion,
+      binaryPath: null,
+    });
+    return;
+  }
+
   const { binaryPath, version } = await ensureBinaryInstalled();
 
   if (command === "install") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vera-ai/cli",
-  "version": "0.3.1",
+  "version": "0.4.1",
   "description": "Bootstrap installer and wrapper for the Vera CLI",
   "license": "MIT",
   "homepage": "https://github.com/lemon07r/Vera#readme",
@@ -13,6 +13,9 @@
     "url": "https://github.com/lemon07r/Vera/issues"
   },
   "bin": "./bin/vera.js",
+  "scripts": {
+    "postinstall": "node ./bin/vera.js _record-install-method"
+  },
   "files": [
     "bin/vera.js",
     "README.md"