superlore-cli 0.7.0 → 0.7.2

package/dist/config.d.ts

@@ -35,6 +35,12 @@ interface SuperloreMcpConfig {
     /** Route the MCP is served at. Defaults to {@link DEFAULT_MCP_PATH}. */
     path?: string;
 }
+/** A navbar logo — light/dark image paths + an optional home link, the mint.json way. */
+interface SuperloreLogo {
+    light?: string;
+    dark?: string;
+    href?: string;
+}
 /** The parsed, validated shape of a `superlore.json` file. */
 interface SuperloreJson {
     /** Human-facing KB name. */
@@ -43,6 +49,12 @@ interface SuperloreJson {
     type: SuperloreType;
     /** Brand accent — any CSS colour. superlore derives the rest of the family (light + dark). */
     accent?: string;
+    /** Visual theme skin: "default" | "mint" (loose — forward-compatible with future skins). */
+    theme?: string;
+    /** Navbar logo — light/dark images + home link (mint.json-style). */
+    logo?: SuperloreLogo;
+    /** Favicon path (svg / png / ico). */
+    favicon?: string;
     /** The human gate. Omitted ⇒ public. */
     auth?: SuperloreAuthConfig;
     /** The agent surface. Omitted ⇒ MCP enabled at the default path. */
@@ -84,4 +96,4 @@ declare function serializeSuperloreJson(config: SuperloreJson): string;
 /** Resolve the MCP path for a config, falling back to the default when enabled and unset. */
 declare function resolveMcpPath(config: SuperloreJson): string | undefined;
 
-export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreMcpConfig, type SuperloreType, parseSuperloreJson, resolveMcpPath, serializeSuperloreJson, validateSuperloreJson };
+export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreLogo, type SuperloreMcpConfig, type SuperloreType, parseSuperloreJson, resolveMcpPath, serializeSuperloreJson, validateSuperloreJson };

package/dist/config.js

@@ -29,6 +29,32 @@ function validateSuperloreJson(input) {
   if (accent !== void 0 && (typeof accent !== "string" || accent.trim().length === 0)) {
     issues.push({ path: "accent", message: "must be a non-empty string (a CSS colour)" });
   }
+  const theme = input.theme;
+  if (theme !== void 0 && (typeof theme !== "string" || theme.trim().length === 0)) {
+    issues.push({ path: "theme", message: "must be a non-empty string" });
+  }
+  const favicon = input.favicon;
+  if (favicon !== void 0 && (typeof favicon !== "string" || favicon.trim().length === 0)) {
+    issues.push({ path: "favicon", message: "must be a non-empty string (a path or URL)" });
+  }
+  let logo;
+  if (input.logo !== void 0) {
+    if (!isRecord(input.logo)) {
+      issues.push({ path: "logo", message: "must be an object" });
+    } else {
+      const l = input.logo;
+      for (const k of ["light", "dark", "href"]) {
+        if (l[k] !== void 0 && (typeof l[k] !== "string" || l[k].trim().length === 0)) {
+          issues.push({ path: `logo.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      logo = {
+        light: typeof l.light === "string" ? l.light : void 0,
+        dark: typeof l.dark === "string" ? l.dark : void 0,
+        href: typeof l.href === "string" ? l.href : void 0
+      };
+    }
+  }
   let auth;
   if (input.auth !== void 0) {
     if (!isRecord(input.auth)) {
@@ -82,6 +108,9 @@ function validateSuperloreJson(input) {
     type
   };
   if (typeof accent === "string") value.accent = accent.trim();
+  if (typeof theme === "string") value.theme = theme.trim();
+  if (typeof favicon === "string") value.favicon = favicon.trim();
+  if (logo && (logo.light || logo.dark || logo.href)) value.logo = logo;
   if (auth) value.auth = auth;
   if (mcp) value.mcp = mcp;
   return { ok: true, value };

package/dist/index.d.ts

@@ -37,6 +37,12 @@ interface SuperloreMcpConfig {
     /** Route the MCP is served at. Defaults to {@link DEFAULT_MCP_PATH}. */
     path?: string;
 }
+/** A navbar logo — light/dark image paths + an optional home link, the mint.json way. */
+interface SuperloreLogo {
+    light?: string;
+    dark?: string;
+    href?: string;
+}
 /** The parsed, validated shape of a `superlore.json` file. */
 interface SuperloreJson {
     /** Human-facing KB name. */
@@ -45,6 +51,12 @@ interface SuperloreJson {
     type: SuperloreType;
     /** Brand accent — any CSS colour. superlore derives the rest of the family (light + dark). */
     accent?: string;
+    /** Visual theme skin: "default" | "mint" (loose — forward-compatible with future skins). */
+    theme?: string;
+    /** Navbar logo — light/dark images + home link (mint.json-style). */
+    logo?: SuperloreLogo;
+    /** Favicon path (svg / png / ico). */
+    favicon?: string;
     /** The human gate. Omitted ⇒ public. */
     auth?: SuperloreAuthConfig;
     /** The agent surface. Omitted ⇒ MCP enabled at the default path. */
@@ -87,10 +99,10 @@ declare function serializeSuperloreJson(config: SuperloreJson): string;
 declare function resolveMcpPath(config: SuperloreJson): string | undefined;
 
 /** The CLI version, kept in sync with package.json at build time. */
-declare const VERSION = "0.7.0";
+declare const VERSION = "0.7.2";
 /** Build the argument parser. Exported for tests; `run()` wires it to argv. */
 declare function buildCli(argv?: readonly string[]): cac.CAC;
 /** Parse argv and dispatch. Reports unknown commands and unexpected errors cleanly. */
 declare function run(argv?: readonly string[]): Promise<void>;
 
-export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreMcpConfig, type SuperloreType, VERSION, buildCli, parseSuperloreJson, resolveMcpPath, run, serializeSuperloreJson, validateSuperloreJson };
+export { DEFAULT_MCP_PATH, SUPERLORE_JSON_FILENAME, SUPERLORE_TYPES, type SuperloreAuthConfig, type SuperloreAuthProvider, type SuperloreJson, type SuperloreJsonIssue, type SuperloreJsonResult, type SuperloreLogo, type SuperloreMcpConfig, type SuperloreType, VERSION, buildCli, parseSuperloreJson, resolveMcpPath, run, serializeSuperloreJson, validateSuperloreJson };

package/dist/index.js

@@ -100,6 +100,32 @@ function validateSuperloreJson(input) {
   if (accent2 !== void 0 && (typeof accent2 !== "string" || accent2.trim().length === 0)) {
     issues.push({ path: "accent", message: "must be a non-empty string (a CSS colour)" });
   }
+  const theme = input.theme;
+  if (theme !== void 0 && (typeof theme !== "string" || theme.trim().length === 0)) {
+    issues.push({ path: "theme", message: "must be a non-empty string" });
+  }
+  const favicon = input.favicon;
+  if (favicon !== void 0 && (typeof favicon !== "string" || favicon.trim().length === 0)) {
+    issues.push({ path: "favicon", message: "must be a non-empty string (a path or URL)" });
+  }
+  let logo;
+  if (input.logo !== void 0) {
+    if (!isRecord(input.logo)) {
+      issues.push({ path: "logo", message: "must be an object" });
+    } else {
+      const l = input.logo;
+      for (const k of ["light", "dark", "href"]) {
+        if (l[k] !== void 0 && (typeof l[k] !== "string" || l[k].trim().length === 0)) {
+          issues.push({ path: `logo.${k}`, message: "must be a non-empty string" });
+        }
+      }
+      logo = {
+        light: typeof l.light === "string" ? l.light : void 0,
+        dark: typeof l.dark === "string" ? l.dark : void 0,
+        href: typeof l.href === "string" ? l.href : void 0
+      };
+    }
+  }
   let auth;
   if (input.auth !== void 0) {
     if (!isRecord(input.auth)) {
@@ -153,6 +179,9 @@ function validateSuperloreJson(input) {
     type
   };
   if (typeof accent2 === "string") value.accent = accent2.trim();
+  if (typeof theme === "string") value.theme = theme.trim();
+  if (typeof favicon === "string") value.favicon = favicon.trim();
+  if (logo && (logo.light || logo.dark || logo.href)) value.logo = logo;
   if (auth) value.auth = auth;
   if (mcp) value.mcp = mcp;
   return { ok: true, value };
@@ -266,9 +295,14 @@ import { homedir, tmpdir } from "os";
 import { join as join2 } from "path";
 import process2 from "process";
 var EXTENSION_ID = "superlore.superlore-preview";
-var DEFAULT_VSIX_URL = "https://superlore.vercel.app/superlore-preview.vsix";
-async function downloadVsix(url = DEFAULT_VSIX_URL) {
-  const res = await fetch(url, { redirect: "follow" });
+var OPENVSX_LATEST_API = "https://open-vsx.org/api/superlore/superlore-preview/latest";
+async function downloadVsix(metaUrl = OPENVSX_LATEST_API) {
+  const meta = await fetch(metaUrl, { redirect: "follow" });
+  if (!meta.ok) throw new Error(`couldn't reach Open VSX (${meta.status} ${meta.statusText})`);
+  const info = await meta.json();
+  const download = info.files?.download;
+  if (!download) throw new Error("Open VSX returned no download URL for the extension");
+  const res = await fetch(download, { redirect: "follow" });
   if (!res.ok) throw new Error(`couldn't fetch the extension (${res.status} ${res.statusText})`);
   const bytes = Buffer.from(await res.arrayBuffer());
   const path = join2(tmpdir(), "superlore-preview.vsix");
@@ -433,10 +467,10 @@ function report(result) {
 function printManualInstall() {
   log.blank();
   log.info(
-    `${dim("Install it by hand: download")} ${cyan("superlore.vercel.app/superlore-preview.vsix")}${dim(",")}`
+    `${dim("Install it by hand: open your editor's Extensions panel and search")} ${cyan('"superlore Preview"')}${dim(" (it's on Open VSX),")}`
   );
   log.info(
-    `${dim("then run")} ${cyan('"Extensions: Install from VSIX\u2026"')} ${dim("in your editor (or")} ${cyan("code --install-extension <file>.vsix")}${dim(").")}`
+    `${dim("or run")} ${cyan("code --install-extension superlore.superlore-preview")} ${dim("(Cursor/Windsurf/VSCodium).")}`
   );
 }
 function printMcpNextStep() {
@@ -2481,7 +2515,7 @@ function printNextSteps(root, config) {
 }
 
 // src/index.ts
-var VERSION = "0.7.0";
+var VERSION = "0.7.2";
 function buildCli(argv = process3.argv) {
   const cli = cac("superlore");
   cli.command("init [dir]", "Scaffold a new superlore knowledge base").option("--name <name>", "KB name").option("--type <type>", "KB type: company-kb | product-docs | personal-kb").option("--auth", "Enable the Google SSO auth gate").option("--no-auth", "Disable the auth gate").option("--allowed-domain <domain>", "Restrict SSO to one email domain (implies --auth)").option("--accent <color>", "Brand accent colour (any CSS colour)").option("--no-mcp", "Disable the MCP endpoint (on by default)").option("--connect", "Install the editor extension after scaffolding (skip the prompt)").option("--no-connect", "Don't set up the editor extension").option("-y, --yes", "Skip prompts; use flags + defaults").example("superlore init my-kb --type product-docs").example("superlore init acme --type company-kb --auth --allowed-domain acme.com").example("superlore init me --type personal-kb").action(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superlore-cli",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "The superlore CLI — scaffold, run, and build an agent-native knowledge base. One corpus. Humans and agents.",
   "license": "Apache-2.0",
   "author": "Krishnan S G",