context-vault 2.11.0 → 2.12.0

package/bin/cli.js

@@ -25,6 +25,7 @@ import { join, resolve, dirname } from "node:path";
 import { homedir, platform } from "node:os";
 import { execSync, execFile, execFileSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
+import { APP_URL, API_URL, MARKETING_URL } from "@context-vault/core/constants";
 
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -272,9 +273,39 @@ async function runSetup() {
       existingVault = cfg.vaultDir || existingVault;
     } catch {}
 
+    // Version check against npm registry (5s timeout, fail silently if offline)
+    let latestVersion = null;
+    try {
+      latestVersion = execSync("npm view context-vault version", {
+        encoding: "utf-8",
+        stdio: ["pipe", "pipe", "pipe"],
+        timeout: 5000,
+      }).trim();
+    } catch {}
+
+    if (latestVersion === VERSION) {
+      console.log(
+        green(`  ✓ context-vault v${VERSION} is up to date`) +
+          dim(`  (vault: ${existingVault})`),
+      );
+      console.log();
+      return;
+    }
+
     console.log(yellow(`  Existing installation detected`));
     console.log(dim(`  Vault: ${existingVault}`));
-    console.log(dim(`  Config: ${existingConfig}`));
+    if (latestVersion) {
+      console.log();
+      console.log(`  Current: ${dim(VERSION)}`);
+      console.log(`  Latest:  ${green(latestVersion)}`);
+      const upgradeCmd = isNpx()
+        ? "npx context-vault@latest setup"
+        : "npm install -g context-vault";
+      console.log();
+      console.log(dim(`  To upgrade: ${upgradeCmd}`));
+    } else {
+      console.log(dim(`  Config: ${existingConfig}`));
+    }
     console.log();
     console.log(`    1) Full reconfigure`);
     console.log(`    2) Update tool configs only ${dim("(skip vault setup)")}`);
@@ -354,6 +385,7 @@ async function runSetup() {
 
       console.log();
       console.log(green("  ✓ Tool configs updated."));
+      console.log(dim("  Restart your AI tools to apply the changes."));
       console.log();
       return;
     }
@@ -501,7 +533,7 @@ async function runSetup() {
   console.log(
     dim("  file paths, or personal data is ever sent. Off by default."),
   );
-  console.log(dim("  Full schema: https://contextvault.dev/telemetry"));
+  console.log(dim(`  Full schema: ${MARKETING_URL}/telemetry`));
   console.log();
 
   let telemetryEnabled = vaultConfig.telemetry === true;
@@ -541,7 +573,12 @@ async function runSetup() {
     console.log(
       `\n  ${dim("[4/6]")}${bold(" Downloading embedding model...")}`,
     );
-    console.log(dim("  all-MiniLM-L6-v2 (~22MB, one-time download)\n"));
+    console.log(dim("  all-MiniLM-L6-v2 (~22MB, one-time download)"));
+    console.log(
+      dim(
+        `  Slow connection? Re-run with --skip-embeddings (enables FTS-only mode)\n`,
+      ),
+    );
     {
       const spinnerFrames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
       let frame = 0;
@@ -731,7 +768,9 @@ async function runSetup() {
   const boxLines = [
     `  ✓ Setup complete — ${passed}/${checks.length} checks passed (${elapsed}s)`,
     ``,
-    `  ${bold("AI Tools")} — open ${toolName} and try:`,
+    `  ${bold("Next:")} restart ${toolName} to activate the vault`,
+    ``,
+    `  ${bold("AI Tools")} — once active, try:`,
     `  "Search my vault for getting started"`,
     `  "Save an insight about [topic]"`,
     `  "Show my vault status"`,
@@ -979,7 +1018,7 @@ This is an example entry showing the decision format. Feel free to delete it.
 
 async function runConnect() {
   const apiKey = getFlag("--key");
-  const hostedUrl = getFlag("--url") || "https://api.context-vault.com";
+  const hostedUrl = getFlag("--url") || API_URL;
 
   if (!apiKey) {
     console.log(`\n  ${bold("context-vault connect")}\n`);
@@ -988,9 +1027,7 @@ async function runConnect() {
     console.log(`    context-vault connect --key cv_...\n`);
     console.log(`  Options:`);
     console.log(`    --key <key>   API key (required)`);
-    console.log(
-      `    --url <url>   Hosted server URL (default: https://api.context-vault.com)`,
-    );
+    console.log(`    --url <url>   Hosted server URL (default: ${API_URL})`);
     console.log();
     return;
   }
@@ -1232,9 +1269,7 @@ async function runSwitch() {
     );
     console.log(`  Options:`);
     console.log(`    --key <key>   API key for hosted mode (cv_...)`);
-    console.log(
-      `    --url <url>   Hosted server URL (default: https://api.context-vault.com)\n`,
-    );
+    console.log(`    --url <url>   Hosted server URL (default: ${API_URL})\n`);
     return;
   }
 
@@ -1291,10 +1326,7 @@ async function runSwitch() {
     console.log(dim(`  Server: node ${launcherPath}`));
     console.log();
   } else {
-    const hostedUrl =
-      getFlag("--url") ||
-      vaultConfig.hostedUrl ||
-      "https://api.context-vault.com";
+    const hostedUrl = getFlag("--url") || vaultConfig.hostedUrl || API_URL;
     const apiKey = getFlag("--key") || vaultConfig.apiKey;
 
     if (!apiKey) {
@@ -1674,15 +1706,13 @@ async function runMigrate() {
       `    context-vault migrate --to-local   Download hosted vault to local files`,
     );
     console.log(`\n  Options:`);
-    console.log(
-      `    --url <url>      Hosted server URL (default: https://api.context-vault.com)`,
-    );
+    console.log(`    --url <url>      Hosted server URL (default: ${API_URL})`);
     console.log(`    --key <key>      API key (cv_...)`);
     console.log();
     return;
   }
 
-  const hostedUrl = getFlag("--url") || "https://api.context-vault.com";
+  const hostedUrl = getFlag("--url") || API_URL;
   const apiKey = getFlag("--key");
 
   if (!apiKey) {

package/node_modules/@context-vault/core/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@context-vault/core",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "type": "module",
   "description": "Shared core: capture, index, retrieve, tools, and utilities for context-vault",
   "main": "src/index.js",

package/node_modules/@context-vault/core/src/constants.js

@@ -1,3 +1,9 @@
+export const APP_URL = "https://app.context-vault.com";
+export const API_URL = "https://api.context-vault.com";
+export const MARKETING_URL = "https://contextvault.dev";
+export const GITHUB_ISSUES_URL =
+  "https://github.com/fellanH/context-vault/issues";
+
 export const MAX_BODY_LENGTH = 100 * 1024; // 100KB
 export const MAX_TITLE_LENGTH = 500;
 export const MAX_KIND_LENGTH = 64;

package/node_modules/@context-vault/core/src/core/telemetry.js

@@ -1,8 +1,10 @@
 import { existsSync, writeFileSync } from "node:fs";
 import { join } from "node:path";
+import { API_URL, MARKETING_URL, GITHUB_ISSUES_URL } from "../constants.js";
 
-const TELEMETRY_ENDPOINT = "https://api.context-vault.com/telemetry";
+const TELEMETRY_ENDPOINT = `${API_URL}/telemetry`;
 const NOTICE_MARKER = ".telemetry-notice-shown";
+const FEEDBACK_PROMPT_MARKER = ".feedback-prompt-shown";
 
 export function isTelemetryEnabled(config) {
   const envVal = process.env.CONTEXT_VAULT_TELEMETRY;
@@ -56,7 +58,31 @@ export function maybeShowTelemetryNotice(dataDir) {
     "[context-vault] Reports contain only: event type, error code, tool name, version, node version, platform, arch, timestamp.",
     "[context-vault] No vault content, file paths, or personal data is ever sent.",
     '[context-vault] Opt in: set "telemetry": true in ~/.context-mcp/config.json or set CONTEXT_VAULT_TELEMETRY=1.',
-    "[context-vault] Full payload schema: https://contextvault.dev/telemetry",
+    `[context-vault] Full payload schema: ${MARKETING_URL}/telemetry`,
+  ];
+  for (const line of lines) {
+    process.stderr.write(line + "\n");
+  }
+}
+
+/**
+ * Print a one-time feedback prompt after the user's first successful save.
+ * Uses a marker file in dataDir to ensure it's only shown once.
+ * Never throws, never blocks.
+ */
+export function maybeShowFeedbackPrompt(dataDir) {
+  try {
+    const markerPath = join(dataDir, FEEDBACK_PROMPT_MARKER);
+    if (existsSync(markerPath)) return;
+    writeFileSync(markerPath, new Date().toISOString() + "\n");
+  } catch {
+    return;
+  }
+
+  const lines = [
+    "[context-vault] First entry saved — nice work!",
+    "[context-vault] Got feedback, a bug, or a feature request?",
+    `[context-vault] Open an issue: ${GITHUB_ISSUES_URL}`,
   ];
   for (const line of lines) {
     process.stderr.write(line + "\n");

package/node_modules/@context-vault/core/src/server/tools/save-context.js

@@ -4,6 +4,7 @@ import { indexEntry } from "../../index/index.js";
 import { categoryFor } from "../../core/categories.js";
 import { normalizeKind } from "../../core/files.js";
 import { ok, err, ensureVaultExists, ensureValidKind } from "../helpers.js";
+import { maybeShowFeedbackPrompt } from "../../core/telemetry.js";
 import {
   MAX_BODY_LENGTH,
   MAX_TITLE_LENGTH,
@@ -398,6 +399,11 @@ export async function handler(
     supersedes,
     userId,
   });
+
+  if (ctx.config?.dataDir) {
+    maybeShowFeedbackPrompt(ctx.config.dataDir);
+  }
+
   const relPath = entry.filePath
     ? entry.filePath.replace(config.vaultDir + "/", "")
     : entry.filePath;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "context-vault",
-  "version": "2.11.0",
+  "version": "2.12.0",
   "type": "module",
   "description": "Persistent memory for AI agents — saves and searches knowledge across sessions",
   "bin": {
@@ -55,7 +55,7 @@
     "@context-vault/core"
   ],
   "dependencies": {
-    "@context-vault/core": "^2.11.0",
+    "@context-vault/core": "^2.12.0",
     "@modelcontextprotocol/sdk": "^1.26.0",
     "sqlite-vec": "^0.1.0"
   }