vault-cortex 0.4.0 → 0.4.2

package/dist/bin.js

@@ -2,7 +2,8 @@
 import { readFileSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 import { minimumNodeVersion, satisfiesMinimum } from "./node-version.js";
-const { version, engines } = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+const pkg = JSON.parse(readFileSync(fileURLToPath(new URL("../package.json", import.meta.url)), "utf8"));
+const { version, engines } = pkg;
 // npm only warns (EBADENGINE) on an engines mismatch but runs the CLI anyway,
 // which would surface as a cryptic crash inside a dependency. Fail with a
 // clear message instead — and only import dependency-laden code after the

package/dist/messages.js

@@ -1,12 +1,15 @@
 import { styleText } from "node:util";
-// Strip styling when stdout isn't a color TTY (piped output, NO_COLOR, CI) so
+// Strip styling when stdout isn't a color TTY (piped output, CI) or NO_COLOR
+// is set (any value, including empty — per the NO_COLOR spec) so
 // captured/redirected output stays plain — no stray escape codes in copied
 // commands or logs.
-const paint = (style, text) => process.stdout.isTTY && !process.env.NO_COLOR ? styleText(style, text) : text;
-// Section header that replaces the old clack note box: a bold title over a
-// dim rule. The rule is its own line (not a per-line prefix), so it never
-// touches a copyable command.
-const connectHeader = () => `${paint("bold", "Connect")}\n${paint("dim", "─".repeat(56))}`;
+const paint = (style, text) => process.stdout.isTTY && !("NO_COLOR" in process.env)
+    ? styleText(style, text)
+    : text;
+const RULE_WIDTH = 56;
+const topRule = (label) => paint("dim", `╭── ${label} ${"─".repeat(Math.max(0, RULE_WIDTH - label.length - 6))}╮`);
+const bottomRule = () => paint("dim", `╰${"─".repeat(RULE_WIDTH - 2)}╯`);
+const sectionRule = (label) => paint("dim", `── ${label} ${"─".repeat(Math.max(0, RULE_WIDTH - label.length - 4))}`);
 const composeUpCommand = (targetDir) => `cd ${targetDir} && docker compose up -d`;
 const startServerLine = (targetDir) => `Start the server:\n  ${composeUpCommand(targetDir)}`;
 /** Remote start line: running, blocked on the missing sync token, or ready to start. */
@@ -75,10 +78,12 @@ export const buildLocalConnectMessage = (params) => {
     // that claude.ai can't reach localhost at all and Claude Desktop needs the
     // mcp-remote bridge (the dialog rejects http, but mcp-remote exempts
     // localhost, so no --allow-http).
-    const connectMessage = `${connectHeader()}
+    const connectMessage = `${topRule("Connect")}
 
 ${startLine}
 
+${sectionRule("MCP client")}
+
 ${connectUrlBlock(`${baseUrl}/mcp`, tokenLine)}
 
 ${connectGuidance(`${baseUrl}/mcp`)}
@@ -93,15 +98,21 @@ it with mcp-remote:
       "--header", "Authorization: Bearer <token above>"]
   }
 
+${sectionRule("Non-OAuth")}
+
 ${curlGuidance(`${baseUrl}/mcp`)}
 
 ${smokeTest(`${baseUrl}/healthz`)}
 
+${sectionRule("Settings")}
+
 Optional settings (timezone, memory folder, port, logging) are commented
 out in ${targetDir}/.env — uncomment, set a value, then apply with
 "docker compose up -d" (restart alone does not re-read .env).
 
-Full docs: https://github.com/aliasunder/vault-cortex/blob/main/deploy/local/README.md`;
+Full docs: https://github.com/aliasunder/vault-cortex/blob/main/deploy/local/README.md
+
+${bottomRule()}`;
     return connectMessage;
 };
 /**
@@ -135,24 +146,32 @@ Claude Desktop only accept https URLs — set up HTTPS for those clients
 (see the HTTPS section in the remote guide).`;
     // Flush-left on purpose: this is printed as plain text (see paint), so
     // leading whitespace would render as literal indentation.
-    const connectMessage = `${connectHeader()}
+    const connectMessage = `${topRule("Connect")}
 
 ${startLine}
 
+${sectionRule("MCP client")}
+
 ${connectUrlBlock(`${publicUrl}/mcp`, tokenLine)}
 
 ${clientGuidance}
 
+${sectionRule("Non-OAuth")}
+
 ${curlGuidance(`${publicUrl}/mcp`)}
 
 ${smokeTest(`${publicUrl}/healthz`)}
 
+${sectionRule("Settings")}
+
 Optional settings (timezone, memory folder, port, logging, sync
 behavior) are commented out in ${targetDir}/.env — uncomment, set a
 value, then apply with "docker compose up -d" (restart alone does not
 re-read .env).
 
 For HTTPS options (API Gateway, Caddy, Cloudflare Tunnel), see:
-https://github.com/aliasunder/vault-cortex/blob/main/deploy/remote/README.md#https-access`;
+https://github.com/aliasunder/vault-cortex/blob/main/deploy/remote/README.md#https-access
+
+${bottomRule()}`;
     return connectMessage;
 };

package/dist/prompts.js

@@ -1,5 +1,7 @@
 import * as clack from "@clack/prompts";
 // User pressed ctrl-C mid-prompt: 130 = 128 + SIGINT, the shell convention.
+// clack.isCancel is a type guard (value is symbol), so after the early exit
+// TypeScript narrows `value` to `T` — no assertion needed.
 const exitOnCancel = (value) => {
     if (clack.isCancel(value)) {
         clack.cancel("Cancelled.");

package/package.json

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