vault-cortex 0.10.2 → 0.10.3

package/dist/docker.js

@@ -86,7 +86,10 @@ export const buildDockerRunArgs = (params) => {
         args.push("--health-interval", "15s");
         args.push("--health-timeout", "5s");
         args.push("--health-retries", "5");
-        args.push("--health-start-period", "60s");
+        // 180s: the remote image's init chain runs the first vault sync to
+        // completion before the MCP server boots, so /healthz appears late on
+        // fresh deploys.
+        args.push("--health-start-period", "180s");
         args.push("--log-driver", "json-file");
         args.push("--log-opt", "max-size=10m");
         args.push("--log-opt", "max-file=3");
@@ -191,6 +194,28 @@ export const probeHealth = async (params, fetchFn) => {
         return false;
     }
 };
+/**
+ * Health-poll budget by deployment mode. Remote gets a longer window because
+ * the container's init chain runs the first vault sync to completion before
+ * the server boots — /healthz can legitimately take minutes to appear on a
+ * fresh deploy (matches the 180s container health start period plus boot
+ * margin).
+ */
+export const healthPollTimeoutMs = (mode) => {
+    return mode === "remote" ? 240_000 : 120_000;
+};
+/** Health-poll failure message with the duration derived from the actual
+ *  timeout, so mode-specific budgets can't drift out of the copy. Remote
+ *  adds a first-sync hint: the container's init chain retries the first
+ *  sync with no upper time bound, so an expired poll does not mean the
+ *  server failed — it may flip healthy after the CLI stops waiting. */
+export const healthTimeoutMessage = (mode, timeoutMs) => {
+    const baseMessage = `Server did not respond within ${timeoutMs / 60_000} minutes — check: docker logs ${CONTAINER_NAME}`;
+    if (mode === "remote") {
+        return `${baseMessage} (a long first sync may still be running — the container keeps starting in the background)`;
+    }
+    return baseMessage;
+};
 /**
  * Polls the health endpoint until it responds OK or the timeout elapses.
  * The first `docker run` pulls the image, so the default window is generous.

package/dist/init.js

@@ -3,7 +3,7 @@ import { join, resolve } from "node:path";
 import { buildLocalEnv, buildRemoteEnv } from "./env.js";
 import { captureObsidianToken } from "./get-sync-token.js";
 import { buildDaemonNotRunningMessage, buildDockerNotInstalledMessage, buildLocalConnectMessage, buildRemoteConnectMessage, startCommand, } from "./messages.js";
-import { pollHealth } from "./docker.js";
+import { healthPollTimeoutMs, healthTimeoutMessage, pollHealth, } from "./docker.js";
 import { reportPublicUrlProbe } from "./lifecycle.js";
 import { applyOptionalSettings, askOptionalSettings, derivePublicUrlOverride, } from "./optional-settings.js";
 import { buildFilesToWrite, readEnvPort, readEnvPublicUrl, writeFiles, } from "./scaffold.js";
@@ -185,9 +185,10 @@ const offerDockerRun = async (params, deps) => {
     }
     const spinner = prompts.spinner();
     spinner.start("Waiting for the server to come up (first run may take a moment)");
-    const healthy = await pollHealth({ url: `http://127.0.0.1:${port}/healthz` }, fetchFn);
+    const timeoutMs = healthPollTimeoutMs(mode);
+    const healthy = await pollHealth({ url: `http://127.0.0.1:${port}/healthz`, timeoutMs }, fetchFn);
     if (!healthy) {
-        spinner.stop("Server did not respond within 2 minutes — check: docker logs vault-cortex");
+        spinner.stop(healthTimeoutMessage(mode, timeoutMs));
         return false;
     }
     spinner.stop("Server is up — health check passed.");

package/dist/lifecycle.js

@@ -1,5 +1,5 @@
 import { join, resolve } from "node:path";
-import { CONTAINER_NAME, pollHealth, probeHealth, } from "./docker.js";
+import { CONTAINER_NAME, healthPollTimeoutMs, healthTimeoutMessage, pollHealth, probeHealth, } from "./docker.js";
 import { buildDaemonNotRunningMessage, buildDockerNotInstalledMessage, } from "./messages.js";
 import { detectMode, hasEnvPublicUrl, readEnvPort, readEnvPublicUrl, readEnvVaultPath, } from "./scaffold.js";
 import { expandTilde } from "./vault.js";
@@ -123,12 +123,13 @@ export const recreateContainer = async (params, deps) => {
     }
     const spinner = prompts.spinner();
     spinner.start("Waiting for the server to come up");
+    const timeoutMs = healthTimeoutMs ?? healthPollTimeoutMs(deployment.mode);
     const healthy = await pollHealth({
         url: `http://127.0.0.1:${deployment.port}/healthz`,
-        timeoutMs: healthTimeoutMs,
+        timeoutMs,
     }, fetchFn);
     if (!healthy) {
-        spinner.stop(`Server did not respond within 2 minutes — check: docker logs ${CONTAINER_NAME}`);
+        spinner.stop(healthTimeoutMessage(deployment.mode, timeoutMs));
         return 1;
     }
     spinner.stop("Server is up — health check passed.");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vault-cortex",
-  "version": "0.10.2",
+  "version": "0.10.3",
   "description": "Set up a Vault Cortex MCP server for your Obsidian vault in one command: npx vault-cortex@latest init",
   "license": "MIT",
   "type": "module",