@context-vault/core 2.11.0 → 2.12.0

package/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/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/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/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;