vault-cortex 0.10.1 → 0.10.2-beta.50

package/README.md

@@ -49,9 +49,9 @@ What it does:
    - **Remote** — a VPS with [Obsidian Sync](https://obsidian.md/sync),
      reachable from any device
 2. Offers the most common optional settings — memory layer and folder,
-   file tools, semantic search, port, timezone (plus sync direction for
-   remote) — press enter to keep the defaults, or pick the ones you want to
-   change
+   daily notes folder and format, file tools, semantic search, port,
+   timezone (plus sync direction for remote) — press enter to keep the
+   defaults, or pick the ones you want to change
 3. Generates a `.env` file with a securely generated `MCP_AUTH_TOKEN`
 4. Optionally starts the container and waits for the health check
 5. Prints your connection details — the MCP URL, your auth token, and how to
@@ -85,11 +85,13 @@ Change optional settings on an existing setup:
 npx vault-cortex@latest configure
 ```
 
-Shows the same settings chooser as [`init`](#init) — memory layer and
-folder, file tools, semantic search, port, timezone (plus sync direction
-for remote) — pre-filled with your current values, saves your picks to
-`.env`, and offers to restart the container so they take effect. Settings not in the chooser
-live in `.env` too: edit the value there, then run [`restart`](#restart).
+Shows the same settings chooser as [`init`](#init), pre-filled with your
+current values, saves your picks to `.env`, and offers to restart the
+container so they take effect.
+
+Settings not in the chooser live in `.env` too: edit the value there, then
+run [`restart`](#restart). That's also how you clear a daily notes setting
+back to your vault's own configuration — comment out or delete its line.
 
 Use `--dir <path>` if your config isn't in `./vault-cortex`.
 

package/dist/configure.js

@@ -20,7 +20,10 @@ export const runConfigure = async (flags, deps) => {
     const envContent = readFileSync(envFilePath, "utf8");
     const pickedOverrides = await askOptionalSettings({ mode, envContent }, prompts);
     if (Object.keys(pickedOverrides).length === 0) {
-        prompts.log("No settings selected — nothing changed.");
+        // Covers both empty-overrides paths: nothing picked in the chooser, and
+        // picked-but-kept (an optionalText prompt left blank logs its own
+        // "Kept the current value" line, which this must not contradict).
+        prompts.log("No changes to apply.");
         prompts.outro("Done.");
         return 0;
     }

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/env.js

@@ -61,12 +61,21 @@ FILE_TOOLS_ENABLED=true
 # Memory folder name in your vault (default: About Me).
 MEMORY_DIR=About Me
 
-# Comma-separated folders protected from deletion (default: MEMORY_DIR, Daily Notes).
-# If your daily notes folder has a custom name (e.g. "Journal"), override to include it.
+# Daily notes folder and filename format (default: read from the
+# vault's .obsidian/daily-notes.json, falling back to "Daily Notes" and
+# YYYY-MM-DD). Folder is any vault-relative path (Journal, Planner/Daily);
+# format takes the same tokens as Obsidian's date format setting.
+# DAILY_NOTES_FOLDER=Journal
+# DAILY_NOTES_FORMAT=YYYY-MM-DD
+
+# Comma-separated folders protected from deletion (default: MEMORY_DIR plus
+# the daily notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes").
+# A custom folder set only in daily-notes.json is not auto-protected.
 # PROTECTED_PATHS=About Me,Daily Notes
 
-# Comma-separated folders excluded from orphan detection
-# (default: Daily Notes, Templates, MEMORY_DIR).
+# Comma-separated folders excluded from orphan detection (default: the daily
+# notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes" — plus
+# Templates and MEMORY_DIR).
 # ORPHAN_EXCLUDE_FOLDERS=Daily Notes,Templates,About Me
 
 # URL shown in OAuth discovery metadata
@@ -154,12 +163,22 @@ FILE_TOOLS_ENABLED=true
 # Memory folder name in your vault (default: About Me).
 MEMORY_DIR=About Me
 
-# Comma-separated folders protected from deletion (default: MEMORY_DIR, Daily Notes).
-# If your daily notes folder has a custom name (e.g. "Journal"), override to include it.
+# Daily notes folder and filename format (default: read from the
+# vault's .obsidian/daily-notes.json, synced to the server via SYNC_CONFIGS
+# below; falls back to "Daily Notes" and YYYY-MM-DD). Folder is any
+# vault-relative path (Journal, Planner/Daily); format takes the same tokens
+# as Obsidian's date format setting.
+# DAILY_NOTES_FOLDER=Journal
+# DAILY_NOTES_FORMAT=YYYY-MM-DD
+
+# Comma-separated folders protected from deletion (default: MEMORY_DIR plus
+# the daily notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes").
+# A custom folder set only in daily-notes.json is not auto-protected.
 # PROTECTED_PATHS=About Me,Daily Notes
 
-# Comma-separated folders excluded from orphan detection
-# (default: Daily Notes, Templates, MEMORY_DIR).
+# Comma-separated folders excluded from orphan detection (default: the daily
+# notes folder — DAILY_NOTES_FOLDER when set, otherwise "Daily Notes" — plus
+# Templates and MEMORY_DIR).
 # ORPHAN_EXCLUDE_FOLDERS=Daily Notes,Templates,About Me
 
 # URL shown in OAuth discovery metadata
@@ -192,6 +211,17 @@ CONFLICT_STRATEGY=merge
 
 # Sync direction: bidirectional | pull-only | push-only (default: bidirectional).
 SYNC_MODE=bidirectional
+
+# Obsidian settings categories to sync into the server's .obsidian/ folder
+# (default: the two the server reads — daily notes settings and community
+# plugin settings such as the Tasks plugin's format; "none" disables).
+# A category only syncs after your desktop pushes it: Obsidian Settings →
+# Sync → "Vault configuration sync" (per device). Some community plugins
+# keep API keys in their settings — server tools never read .obsidian/,
+# but synced settings do live on the server volume. Values: app,
+# appearance, appearance-data, hotkey, core-plugin, core-plugin-data,
+# community-plugin, community-plugin-data — comma-separated.
+SYNC_CONFIGS=core-plugin-data,community-plugin-data
 `;
 // sync:remote-optional:end
 export const buildLocalEnv = (answers) => `# vault-cortex — local quickstart

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/dist/messages.js

@@ -166,8 +166,8 @@ ${nonOauthBlocks}
 
 ${sectionRule("Settings")}
 
-Adjust optional settings (memory layer and folder, file tools,
-semantic search, port, timezone):
+Adjust optional settings (memory layer and folder, daily notes
+folder and format, file tools, semantic search, port, timezone):
   npx vault-cortex@latest configure --dir "${targetDir}"
 
 Or edit ${targetDir}/.env directly — change a value (uncommenting it
@@ -231,8 +231,9 @@ ${remoteHealthCheckBlock(`${publicUrl}/healthz`, started)}
 
 ${sectionRule("Settings")}
 
-Adjust optional settings (memory layer and folder, file tools,
-semantic search, port, timezone, sync direction):
+Adjust optional settings (memory layer and folder, daily notes
+folder and format, file tools, semantic search, port, timezone,
+sync direction):
   npx vault-cortex@latest configure --dir "${targetDir}"
 
 Or edit ${targetDir}/.env directly — change a value (uncommenting it

package/dist/optional-settings.js

@@ -17,6 +17,20 @@ const OPTIONAL_SETTINGS = [
         defaultValue: "About Me",
         requiresToggle: "MEMORY_ENABLED",
     },
+    {
+        kind: "optionalText",
+        name: "DAILY_NOTES_FOLDER",
+        label: "Daily notes folder",
+        question: "Vault folder for daily notes:",
+        placeholder: "blank = use your vault's daily notes settings",
+    },
+    {
+        kind: "optionalText",
+        name: "DAILY_NOTES_FORMAT",
+        label: "Daily notes format",
+        question: "Filename date format for daily notes (e.g. YYYY-MM-DD):",
+        placeholder: "blank = use your vault's daily notes settings",
+    },
     {
         kind: "toggle",
         name: "FILE_TOOLS_ENABLED",
@@ -176,7 +190,34 @@ const askFolder = async (params, prompts) => {
     prompts.error("The folder name can't be empty.");
     return askFolder(params, prompts);
 };
-/** Routes a picked setting to its kind's prompt and returns the .env value. */
+/**
+ * Text prompt for a setting whose absence is meaningful — the server falls
+ * back to the vault's own config when the var is unset. Blank-when-unset
+ * writes nothing; blank-when-set keeps the current value. Returns undefined
+ * on skip or no-op so the caller never rewrites for nothing. No removal
+ * path — clearing is a manual .env edit.
+ */
+const askOptionalText = async (params, prompts) => {
+    const { question, placeholder, currentValue } = params;
+    const answer = (await prompts.text(question, {
+        defaultValue: currentValue,
+        placeholder: currentValue === undefined
+            ? placeholder
+            : "blank = keep the current value",
+    })).trim();
+    if (answer !== "" && answer !== currentValue)
+        return answer;
+    if (currentValue === undefined) {
+        prompts.log("Left unset — the server reads this setting from your vault's own config.");
+        return undefined;
+    }
+    prompts.log(`Kept the current value (${currentValue}).`);
+    return undefined;
+};
+/**
+ * Routes a picked setting to its kind's prompt and returns the .env value —
+ * or undefined when an optionalText prompt was left blank (nothing to write).
+ */
 const askSettingValue = async (params, prompts) => {
     const { setting, currentValue } = params;
     switch (setting.kind) {
@@ -194,6 +235,12 @@ const askSettingValue = async (params, prompts) => {
                 currentValue,
                 defaultValue: setting.defaultValue,
             }, prompts);
+        case "optionalText":
+            return askOptionalText({
+                question: setting.question,
+                placeholder: setting.placeholder,
+                currentValue,
+            }, prompts);
         case "choice":
             return prompts.select(setting.question, setting.choices, currentValue ?? setting.defaultValue);
     }
@@ -222,12 +269,15 @@ export const askOptionalSettings = async (params, prompts) => {
     });
     const pickedNames = await prompts.multiselect("Any optional settings to change? (press enter to skip)", chooserOptions);
     // Sequential prompting: answers are gathered one at a time in the curated
-    // order, so the record builds up inside an honest loop.
+    // order, so the record builds up inside an honest loop. An undefined answer
+    // (an optionalText prompt left blank) writes nothing.
     const overrides = {};
     for (const setting of offeredSettings) {
         if (!pickedNames.includes(setting.name))
             continue;
-        overrides[setting.name] = await askSettingValue({ setting, currentValue: readOptionalValue(envContent, setting.name) }, prompts);
+        const value = await askSettingValue({ setting, currentValue: readOptionalValue(envContent, setting.name) }, prompts);
+        if (value !== undefined)
+            overrides[setting.name] = value;
     }
     return overrides;
 };

package/package.json

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