@mavea/mavea 1.0.7 → 1.0.8

package/README.md

@@ -3,8 +3,8 @@
 # Mavéa
 
 <picture>
-  <source media="(prefers-color-scheme: dark)" srcset="docs/media/mascot-dark.svg" />
-  <img src="docs/media/mascot-light.svg" width="150" alt="The Mavéa presence" />
+  <source media="(prefers-color-scheme: dark)" srcset="https://cdn.jsdelivr.net/npm/@mavea/mavea@latest/docs/media/mascot-dark.svg" />
+  <img src="https://cdn.jsdelivr.net/npm/@mavea/mavea@latest/docs/media/mascot-light.svg" width="150" alt="The Mavéa presence" />
 </picture>
 
 ### Talk to AI. See what it means.
@@ -20,7 +20,9 @@ and evidence you can check, marking the exact figure each line is about.
 [See it in motion →](docs/FEATURES.md)
 
 <p>
-  <a href="https://github.com/TryMaveaAI/mavea/actions/workflows/ci.yml"><img src="https://github.com/TryMaveaAI/mavea/actions/workflows/ci.yml/badge.svg" alt="CI status" /></a>
+  <!-- No CI status badge: GitHub Actions badges for a PRIVATE repo require authentication, so
+       they 404 for anyone viewing this README anonymously (e.g. on npm's package page). Add one
+       back the day this repo goes public. -->
   <img src="https://img.shields.io/badge/React-19-61DAFB?style=flat-square&logo=react&logoColor=black" alt="React 19" />
   <img src="https://img.shields.io/badge/TypeScript-6-3178C6?style=flat-square&logo=typescript&logoColor=white" alt="TypeScript 6" />
   <img src="https://img.shields.io/badge/Vite-8-646CFF?style=flat-square&logo=vite&logoColor=white" alt="Vite 8" />

package/bin/mavea.mjs

@@ -1,11 +1,19 @@
 #!/usr/bin/env node
-// mavea CLI — serves the prebuilt app locally, same-origin proxies included, so `npx mavea`
+// mavea CLI — serves the prebuilt app locally, same-origin proxies included, so `npx @mavea/mavea`
 // works exactly the way `pnpm dev` does in the source repo (see vite.config.ts, which this
 // mirrors) without needing Node deps, a clone, or a build step.
 import { createServer } from 'node:http';
 import http from 'node:http';
 import https from 'node:https';
-import { createReadStream, existsSync, statSync, mkdirSync, renameSync, unlinkSync } from 'node:fs';
+import {
+  createReadStream,
+  existsSync,
+  statSync,
+  mkdirSync,
+  renameSync,
+  unlinkSync,
+  realpathSync,
+} from 'node:fs';
 import { writeFile } from 'node:fs/promises';
 import { fileURLToPath } from 'node:url';
 import { dirname, join, extname, normalize, resolve, sep } from 'node:path';
@@ -48,7 +56,7 @@ export const LOCAL_SECURITY_HEADERS = Object.freeze({
 });
 
 // The ONNX runtime WASM (13MB) and Silero VAD model (2.3MB) are real functional assets voice
-// mode needs, not waste — but bundling them into every `npx mavea` download costs everyone that
+// mode needs, not waste — but bundling them into every `npx @mavea/mavea` download costs everyone that
 // weight even if they never touch voice (most turns are text). Both are ALSO already public,
 // permanently-versioned npm package assets, so instead of shipping them in dist/ (see the `files`
 // exclusion in package.json), they're fetched ONCE from jsDelivr's npm CDN the first time voice
@@ -68,7 +76,7 @@ const LAZY_ASSETS = {
 };
 
 // Standard per-OS cache location (the same convention env-paths/XDG use) — persists across
-// `npx mavea` invocations (npx's own package cache does NOT persist these, since they're fetched
+// `npx @mavea/mavea` invocations (npx's own package cache does NOT persist these, since they're fetched
 // at runtime, not installed), so a user only pays the download once, ever, per machine.
 function lazyCacheDir() {
   const plat = platform();
@@ -899,12 +907,12 @@ async function offerDockerInstall() {
 
   const later =
     '  To enable voice later: install Docker (https://docker.com/get-started),\n' +
-    '  then re-run `npx mavea` — it will detect Docker and set voice up for you.';
+    '  then re-run `npx @mavea/mavea` — it will detect Docker and set voice up for you.';
 
   if (process.platform === 'darwin' && commandExists('brew')) {
     const yes = await askYesNo(
       '  Install Docker now via Homebrew? [Y/n]  (~600 MB, then launch Docker\n' +
-        '  Desktop once and re-run `npx mavea` — voice will offer to start itself) ',
+        '  Desktop once and re-run `npx @mavea/mavea` — voice will offer to start itself) ',
     );
     if (!yes) return console.log('  Skipping.\n' + later);
     const r = spawn('brew', ['install', '--cask', 'docker'], { stdio: 'inherit' });
@@ -912,7 +920,7 @@ async function offerDockerInstall() {
       console.log(
         code === 0
           ? '  ✓ Docker installed. Launch Docker Desktop once (to accept its service\n' +
-              '    agreement), then re-run `npx mavea` to enable voice.'
+              '    agreement), then re-run `npx @mavea/mavea` to enable voice.'
           : '  Homebrew install failed.\n' + later,
       );
     });
@@ -922,7 +930,7 @@ async function offerDockerInstall() {
   if (process.platform === 'win32' && commandExists('winget')) {
     const yes = await askYesNo(
       '  Install Docker Desktop now via winget? [Y/n]  (then launch it once and\n' +
-        '  re-run `npx mavea` — voice will offer to start itself) ',
+        '  re-run `npx @mavea/mavea` — voice will offer to start itself) ',
     );
     if (!yes) return console.log('  Skipping.\n' + later);
     const r = spawn('winget', ['install', '-e', '--id', 'Docker.DockerDesktop'], {
@@ -931,7 +939,7 @@ async function offerDockerInstall() {
     r.on('exit', (code) => {
       console.log(
         code === 0
-          ? '  ✓ Docker installed. Launch Docker Desktop once, then re-run `npx mavea`.'
+          ? '  ✓ Docker installed. Launch Docker Desktop once, then re-run `npx @mavea/mavea`.'
           : '  winget install failed.\n' + later,
       );
     });
@@ -942,7 +950,9 @@ async function offerDockerInstall() {
     // Docker's install script needs sudo — print it, never run it on the user's behalf.
     console.log('  To install Docker, run:\n');
     console.log('    curl -fsSL https://get.docker.com | sh\n');
-    console.log('  then re-run `npx mavea` — it will detect Docker and set voice up for you.');
+    console.log(
+      '  then re-run `npx @mavea/mavea` — it will detect Docker and set voice up for you.',
+    );
     return;
   }
 
@@ -957,7 +967,9 @@ async function offerDockerStart() {
   if (process.platform === 'darwin' || process.platform === 'win32') {
     const yes = await askYesNo('  Start Docker Desktop now? [Y/n] ');
     if (!yes) {
-      console.log('  Skipping — captions only. Start Docker Desktop and re-run `npx mavea`.');
+      console.log(
+        '  Skipping — captions only. Start Docker Desktop and re-run `npx @mavea/mavea`.',
+      );
       return;
     }
     if (process.platform === 'darwin') {
@@ -972,14 +984,14 @@ async function offerDockerStart() {
     const up = await waitForDocker();
     if (!up) {
       console.log('\n  Docker did not come up in time — captions only for now.');
-      console.log('  Once Docker Desktop is running, re-run `npx mavea` to enable voice.');
+      console.log('  Once Docker Desktop is running, re-run `npx @mavea/mavea` to enable voice.');
       return;
     }
     console.log('✓');
     startKokoro();
     return;
   }
-  console.log('  Start it (e.g. `sudo systemctl start docker`), then re-run `npx mavea`.');
+  console.log('  Start it (e.g. `sudo systemctl start docker`), then re-run `npx @mavea/mavea`.');
 }
 
 async function maybeOfferVoice() {
@@ -988,7 +1000,7 @@ async function maybeOfferVoice() {
   if (!existsSync(COMPOSE_FILE) || !process.stdin.isTTY) {
     console.log(
       "Voice (Kokoro TTS) isn't running — lines will show as captions only. " +
-        'Re-run `npx mavea` in a terminal to set it up, or start Kokoro yourself on :8880.',
+        'Re-run `npx @mavea/mavea` in a terminal to set it up, or start Kokoro yourself on :8880.',
     );
     return;
   }
@@ -997,7 +1009,7 @@ async function maybeOfferVoice() {
   console.log(VOICE_INTRO);
   const yes = await askYesNo('  Start it now? [Y/n] ');
   if (!yes) {
-    console.log('  Skipping — captions only. Re-run `npx mavea` any time to enable voice.');
+    console.log('  Skipping — captions only. Re-run `npx @mavea/mavea` any time to enable voice.');
     return;
   }
   startKokoro();
@@ -1016,7 +1028,7 @@ async function main() {
   if (args.help) {
     console.log(`mavea — run the Mavéa app locally
 
-Usage: npx mavea [options]
+Usage: npx @mavea/mavea [options]
 
 Options:
   --port, -p <n>   Port to serve on (default 4173, or $PORT)
@@ -1070,7 +1082,20 @@ Terms, privacy, disclaimer, and third-party notices ship with this package.
   if (args.voice) await maybeOfferVoice();
 }
 
-const isMain = process.argv[1] && resolve(process.argv[1]) === fileURLToPath(import.meta.url);
+// npm/npx installs `bin` entries as a symlink (node_modules/.bin/mavea -> ../@mavea/mavea/bin/
+// mavea.mjs). Node's ESM loader resolves that symlink when setting import.meta.url to this
+// module's REAL path, but path.resolve(process.argv[1]) does not dereference symlinks — it stays
+// the symlink's own path, so the two never matched and `npx @mavea/mavea` silently ran main() 0 times.
+// realpathSync resolves both sides to the same real filesystem path before comparing.
+function isMainModule() {
+  if (!process.argv[1]) return false;
+  try {
+    return realpathSync(resolve(process.argv[1])) === fileURLToPath(import.meta.url);
+  } catch {
+    return false;
+  }
+}
+const isMain = isMainModule();
 if (isMain) {
   void main().catch((error) => {
     console.error(`mavea: ${error instanceof Error ? error.message : String(error)}`);

package/docs/media/mascot-dark.svg

@@ -0,0 +1,53 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 220" role="img" aria-label="The Mavéa presence">
+  <defs>
+    <linearGradient id="bell" x1="40" y1="60" x2="160" y2="104" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#63e0bd" />
+      <stop offset="0.5" stop-color="#a4b4ff" />
+      <stop offset="1" stop-color="#ffa5c3" />
+    </linearGradient>
+    <radialGradient id="halo" cx="0.5" cy="0.42" r="0.5">
+      <stop offset="0" stop-color="#9eb0ff" stop-opacity="0.34" />
+      <stop offset="0.66" stop-color="#9eb0ff" stop-opacity="0" />
+    </radialGradient>
+  </defs>
+  <ellipse cx="100" cy="88" rx="98" ry="96" fill="url(#halo)" />
+    <g stroke="#63e0bd" fill="none" stroke-linecap="round">
+      <path d="M62 118 C56 142 66 158 56 186" stroke-width="10" opacity="0.2" />
+      <path d="M62 118 C56 142 66 158 56 186" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#a4b4ff" fill="none" stroke-linecap="round">
+      <path d="M84 121 C84 146 74 162 84 194" stroke-width="10" opacity="0.2" />
+      <path d="M84 121 C84 146 74 162 84 194" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#c3a5ff" fill="none" stroke-linecap="round">
+      <path d="M108 121 C110 144 100 162 110 192" stroke-width="10" opacity="0.2" />
+      <path d="M108 121 C110 144 100 162 110 192" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#ffa5c3" fill="none" stroke-linecap="round">
+      <path d="M130 118 C138 140 128 156 138 184" stroke-width="10" opacity="0.2" />
+      <path d="M130 118 C138 140 128 156 138 184" stroke-width="3.5" opacity="0.65" />
+    </g>
+  <g>
+    <path d="M38 96 C38 52 62 26 100 26 C138 26 162 52 162 96 C162 110 146 116 100 116 C54 116 38 110 38 96 Z" fill="url(#bell)" opacity="0.9" />
+    <path d="M48 88 C48 58 66 38 92 36" fill="none" stroke="#eafff6" stroke-width="4" stroke-linecap="round" opacity="0.5" />
+    <path d="M52 74 C70 62 130 62 148 74" fill="none" stroke="#ffffff" stroke-width="5" stroke-linecap="round" opacity="0.1" />
+    <path d="M58 56 C76 46 124 46 142 56" fill="none" stroke="#ffffff" stroke-width="4" stroke-linecap="round" opacity="0.08" />
+    <g>
+      <ellipse cx="66" cy="86" rx="8" ry="5" fill="#ff9fb6" opacity="0.35" />
+      <ellipse cx="134" cy="86" rx="8" ry="5" fill="#ff9fb6" opacity="0.35" />
+      <g>
+        <circle cx="80" cy="72" r="9" fill="#ffffff" />
+        <circle cx="80" cy="72.7" r="5.2" fill="#252c55" />
+        <circle cx="82.5" cy="69.3" r="2.3" fill="#ffffff" />
+        <circle cx="78" cy="75.1" r="1.2" fill="#ffffff" opacity="0.85" />
+      </g>
+      <g>
+        <circle cx="120" cy="72" r="9" fill="#ffffff" />
+        <circle cx="120" cy="72.7" r="5.2" fill="#252c55" />
+        <circle cx="122.5" cy="69.3" r="2.3" fill="#ffffff" />
+        <circle cx="118" cy="75.1" r="1.2" fill="#ffffff" opacity="0.85" />
+      </g>
+      <path d="M92 91 Q100 97 108 91" fill="none" stroke="#ffffff" stroke-width="3.6" stroke-linecap="round" />
+    </g>
+  </g>
+</svg>

package/docs/media/mascot-light.svg

@@ -0,0 +1,53 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 200 220" role="img" aria-label="The Mavéa presence">
+  <defs>
+    <linearGradient id="bell" x1="40" y1="60" x2="160" y2="104" gradientUnits="userSpaceOnUse">
+      <stop offset="0" stop-color="#57baa6" />
+      <stop offset="0.5" stop-color="#8998d9" />
+      <stop offset="1" stop-color="#d08dab" />
+    </linearGradient>
+    <radialGradient id="halo" cx="0.5" cy="0.42" r="0.5">
+      <stop offset="0" stop-color="#8495d9" stop-opacity="0.34" />
+      <stop offset="0.66" stop-color="#8495d9" stop-opacity="0" />
+    </radialGradient>
+  </defs>
+  <ellipse cx="100" cy="88" rx="98" ry="96" fill="url(#halo)" />
+    <g stroke="#57baa6" fill="none" stroke-linecap="round">
+      <path d="M62 118 C56 142 66 158 56 186" stroke-width="10" opacity="0.2" />
+      <path d="M62 118 C56 142 66 158 56 186" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#8998d9" fill="none" stroke-linecap="round">
+      <path d="M84 121 C84 146 74 162 84 194" stroke-width="10" opacity="0.2" />
+      <path d="M84 121 C84 146 74 162 84 194" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#a18cd9" fill="none" stroke-linecap="round">
+      <path d="M108 121 C110 144 100 162 110 192" stroke-width="10" opacity="0.2" />
+      <path d="M108 121 C110 144 100 162 110 192" stroke-width="3.5" opacity="0.65" />
+    </g>
+    <g stroke="#d08dab" fill="none" stroke-linecap="round">
+      <path d="M130 118 C138 140 128 156 138 184" stroke-width="10" opacity="0.2" />
+      <path d="M130 118 C138 140 128 156 138 184" stroke-width="3.5" opacity="0.65" />
+    </g>
+  <g>
+    <path d="M38 96 C38 52 62 26 100 26 C138 26 162 52 162 96 C162 110 146 116 100 116 C54 116 38 110 38 96 Z" fill="url(#bell)" opacity="0.9" />
+    <path d="M48 88 C48 58 66 38 92 36" fill="none" stroke="#eafff6" stroke-width="4" stroke-linecap="round" opacity="0.5" />
+    <path d="M52 74 C70 62 130 62 148 74" fill="none" stroke="#ffffff" stroke-width="5" stroke-linecap="round" opacity="0.1" />
+    <path d="M58 56 C76 46 124 46 142 56" fill="none" stroke="#ffffff" stroke-width="4" stroke-linecap="round" opacity="0.08" />
+    <g>
+      <ellipse cx="66" cy="86" rx="8" ry="5" fill="#ff9fb6" opacity="0.35" />
+      <ellipse cx="134" cy="86" rx="8" ry="5" fill="#ff9fb6" opacity="0.35" />
+      <g>
+        <circle cx="80" cy="72" r="9" fill="#ffffff" />
+        <circle cx="80" cy="72.7" r="5.2" fill="#252c55" />
+        <circle cx="82.5" cy="69.3" r="2.3" fill="#ffffff" />
+        <circle cx="78" cy="75.1" r="1.2" fill="#ffffff" opacity="0.85" />
+      </g>
+      <g>
+        <circle cx="120" cy="72" r="9" fill="#ffffff" />
+        <circle cx="120" cy="72.7" r="5.2" fill="#252c55" />
+        <circle cx="122.5" cy="69.3" r="2.3" fill="#ffffff" />
+        <circle cx="118" cy="75.1" r="1.2" fill="#ffffff" opacity="0.85" />
+      </g>
+      <path d="M92 91 Q100 97 108 91" fill="none" stroke="#ffffff" stroke-width="3.6" stroke-linecap="round" />
+    </g>
+  </g>
+</svg>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mavea/mavea",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "type": "module",
   "description": "Mavéa — an AI Presence interface. Talk to AI. See what it means.",
   "license": "PolyForm-Noncommercial-1.0.0",
@@ -13,6 +13,7 @@
     "!dist/ort-wasm-simd-threaded.wasm",
     "!dist/silero_vad_v5.onnx",
     "bin",
+    "docs/media",
     "docker-compose.yml",
     "gateway",
     "!gateway/.gateway-data/**",