vesper-wizard 2.3.5 → 2.3.7

package/README.md

@@ -14,6 +14,7 @@ That's it. The wizard handles everything:
 2. Initializes a local credentials vault in unified-key mode (no external API keys required)
 3. Installs `@vespermcp/mcp-server` and auto-configures MCP for all detected agents (Claude, Cursor, VS Code, Codex, Gemini CLI)
 4. Verifies the installation
+5. Prints a sign-in URL for manual browser login (no forced auto-open)
 
 ## What you get
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vesper-wizard",
-  "version": "2.3.5",
+  "version": "2.3.7",
   "description": "Zero-friction setup wizard for Vesper — local MCP server, unified dataset API, and agent auto-config in 60 seconds",
   "bin": {
     "vesper-wizard": "wizard.js"

package/wizard.js

@@ -18,6 +18,7 @@ const readline = require('readline');
 const HOME = os.homedir();
 const VESPER_DIR = path.join(HOME, '.vesper');
 const CONFIG_TOML = path.join(VESPER_DIR, 'config.toml');
+const CONFIG_JSON = path.join(VESPER_DIR, 'config.json');
 const DATA_DIR = path.join(VESPER_DIR, 'data');
 const IS_WIN = process.platform === 'win32';
 const APPDATA = process.env.APPDATA || path.join(HOME, 'AppData', 'Roaming');
@@ -49,6 +50,32 @@ function writeToml(filePath, data) {
   fs.writeFileSync(filePath, lines.join('\n') + '\n', 'utf8');
 }
 
+function readWizardState() {
+  if (!fs.existsSync(CONFIG_JSON)) return {};
+  try {
+    const content = fs.readFileSync(CONFIG_JSON, 'utf8').trim();
+    return content ? JSON.parse(content) : {};
+  } catch {
+    return {};
+  }
+}
+
+function writeWizardState(state) {
+  ensureDir(path.dirname(CONFIG_JSON));
+  fs.writeFileSync(CONFIG_JSON, JSON.stringify(state, null, 2), 'utf8');
+}
+
+function hasCompletedOnboarding() {
+  const state = readWizardState();
+  return state.onboardingCompleted === true;
+}
+
+function markOnboardingCompleted() {
+  const state = readWizardState();
+  state.onboardingCompleted = true;
+  writeWizardState(state);
+}
+
 function dim(text) { return `\x1b[2m${text}\x1b[0m`; }
 function bold(text) { return `\x1b[1m${text}\x1b[0m`; }
 function green(text) { return `\x1b[32m${text}\x1b[0m`; }
@@ -155,6 +182,10 @@ function openBrowser(url) {
   } catch { /* browser open is best-effort */ }
 }
 
+function isInteractiveTerminal() {
+  return Boolean(process.stdin && process.stdin.isTTY && process.stdout && process.stdout.isTTY);
+}
+
 function askYesNo(question) {
   return new Promise((resolve) => {
     const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
@@ -282,8 +313,14 @@ async function deviceAuthFlow() {
   console.log(`  │                                               │`);
   console.log(`  └───────────────────────────────────────────────┘\n`);
 
-  openBrowser(loginUrl);
-  console.log(`  ${dim('Browser opened automatically.')}`);
+  const shouldAutoOpenBrowser = process.env.VESPER_WIZARD_AUTO_OPEN === '1';
+  if (shouldAutoOpenBrowser && !hasCompletedOnboarding()) {
+    openBrowser(loginUrl);
+    markOnboardingCompleted();
+    console.log(`  ${dim('Browser opened automatically (enabled via VESPER_WIZARD_AUTO_OPEN=1).')}`);
+  } else {
+    console.log(`  ${dim('Browser auto-open disabled. Open the URL manually to continue.')}`);
+  }
   console.log(`  ${dim('Waiting for you to sign in...')}\n`);
 
   // Step 3: Poll until confirmed or expired
@@ -437,6 +474,13 @@ async function checkServerHealth() {
 
 // ── Main Wizard ──────────────────────────────────────────────
 async function main() {
+  if (!isInteractiveTerminal()) {
+    console.error(red('vesper-wizard is interactive and cannot run in MCP stdio mode.'));
+    console.error(dim('Use this command for MCP server runtime instead:'));
+    console.error(cyan('npx -y -p @vespermcp/mcp-server@latest vespermcp'));
+    process.exit(2);
+  }
+
   printBanner();
 
   console.log(`  ${green('→')} Setting up Vesper on ${bold(os.hostname())}\n`);
@@ -487,17 +531,22 @@ async function main() {
   console.log(` ${green('✓')}`);
   console.log(`      ${dim('Mode:')} ${dim(vaultData.auth_mode === 'cloud' ? 'cloud (linked to Vesper account)' : 'single local Vesper key (no external keys required)')}`);
 
-  // ─── Step 4: Install @vespermcp/mcp-server ─────────────────
-  console.log(`\n  ${dim('[')}${cyan('4/6')}${dim(']')} Installing Vesper MCP server...`);
+  // ─── Step 4: Verify @vespermcp/mcp-server command ───────────
+  console.log(`\n  ${dim('[')}${cyan('4/6')}${dim(']')} Verifying Vesper MCP server command...`);
   try {
     const npmCmd = IS_WIN ? 'npx.cmd' : 'npx';
-    spawnSync(npmCmd, ['-y', '@vespermcp/mcp-server@latest', '--setup', '--silent'], {
-      stdio: 'inherit',
-      timeout: 120000,
+    const verify = spawnSync(npmCmd, ['-y', '-p', '@vespermcp/mcp-server@latest', 'vespermcp', '--version'], {
+      stdio: 'pipe',
+      timeout: 30000,
+      encoding: 'utf8',
     });
-    console.log(`      ${green('✓')} @vespermcp/mcp-server installed`);
+    if (verify.status === 0) {
+      console.log(`      ${green('✓')} @vespermcp/mcp-server command is available`);
+    } else {
+      console.log(`      ${yellow('⚠')} Could not verify vespermcp binary. MCP clients will still install it on first run.`);
+    }
   } catch {
-    console.log(`      ${yellow('⚠')} Could not auto-install — run manually: npx -y @vespermcp/mcp-server@latest --setup`);
+    console.log(`      ${yellow('⚠')} Could not verify vespermcp binary. MCP clients will still install it on first run.`);
   }
 
   // ─── Step 5: Auto-configure all detected IDEs ──────────────