@mclean-capital/neura 2.0.0 → 2.1.0

package/README.md

@@ -16,6 +16,34 @@ This fetches the CLI **plus** the bundled core service and its native dependenci
 
 Requires **Node.js >= 22**.
 
+### Supported platforms
+
+| Platform                            | Supported |
+| ----------------------------------- | :-------: |
+| macOS — Apple Silicon (M1/M2/M3/M4) |    Yes    |
+| macOS — Intel (x64)                 |  **No**   |
+| Windows — x64 / arm64               |    Yes    |
+| Linux — x64 / arm64                 |    Yes    |
+
+**Intel Macs are not supported.** Neura's wake-word detector runs on
+`onnxruntime-node`, and upstream dropped Intel Mac (`darwin/x64`) binaries
+starting with version 1.24. Because voice is a required feature — not an
+optional one — `npm install -g @mclean-capital/neura` will appear to
+succeed but core will crash at startup with
+`Cannot find module '../bin/napi-v6/darwin/x64/onnxruntime_binding.node'`.
+
+If you're on an Apple Silicon Mac but see the `darwin/x64` error, you've
+installed the Intel build of Node under Rosetta. Reinstall Node as arm64:
+
+```bash
+nvm uninstall <version>
+arch -arm64 nvm install <version>
+```
+
+For true Intel Macs, there's no workaround short of self-building against
+an older onnxruntime-node — we recommend running Neura on a supported
+machine instead.
+
 ## Quick start
 
 ```bash
@@ -26,7 +54,21 @@ neura listen      # voice chat (mic + speaker, wake-word ready)
 neura chat        # text chat from your terminal
 ```
 
-After `neura install` completes, core runs as a background OS service (launchd on macOS, systemd on Linux). Say your wake word — by default **"jarvis"** — and Neura activates a voice session. Stop talking for 5 minutes and it drops back to passive listening.
+After `neura install` completes, core runs as a background OS service — launchd on macOS, systemd on Linux, a Scheduled Task (or Startup folder shim as fallback) on Windows. Say your wake word — by default **"jarvis"** — and Neura activates a voice session. Stop talking for 5 minutes and it drops back to passive listening.
+
+### Windows notes
+
+Windows doesn't have a clean "run as background service" path for a voice-first assistant. A proper Windows Service (via `sc.exe`, nssm, or WinSW) runs in **Session 0**, which is isolated from every interactive user session and cannot access the user's microphone or audio devices — a hard blocker for wake-word detection. So on Windows we use a per-user **Scheduled Task** instead, registered by `schtasks.exe` with `/SC ONLOGON /RL LIMITED`. No UAC prompt, no admin rights, no bundled binaries.
+
+If `schtasks /Create` refuses (some corporate / GPO-locked Windows configurations require elevation even for user-level tasks), `neura install` transparently falls back to a `neura-core.cmd` launcher in `%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\`. The core still starts on next logon — `neura install` will tell you which path was taken so you know what to expect.
+
+Trade-offs you should know about on Windows:
+
+- **The core only runs while you're logged in.** When you log out, it stops; when you log back in, Windows starts it again. There's no pre-login boot. If you need 24/7 availability, use macOS or Linux.
+- **Status telemetry is thinner** than a real service. `neura status` reports up/down by pid, but there's no Windows event-log integration or automatic crash-restart policy beyond "start fresh on next logon".
+- **The Task Scheduler path is manageable from the GUI.** Open Task Scheduler and look for `neura-core` under the top-level Task Scheduler Library. If you took the Startup folder fallback, the shim is at the path above — delete the file to disable.
+
+`neura config set` works normally on Windows. The launcher shim only exports `NEURA_HOME`, so the core re-reads `config.json` on every restart — same behavior as macOS and Linux. Changes take effect on the next `neura restart` without needing `neura install`.
 
 ## Update
 

package/core/server.bundled.mjs

@@ -50558,7 +50558,7 @@ var Logger = class _Logger {
 };
 
 // src/server/lifecycle.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3, rmSync, unlinkSync } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, rmSync, unlinkSync, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2, join as join2 } from "path";
 import { fileURLToPath } from "url";
 
@@ -69098,6 +69098,23 @@ async function initServices() {
   if (config.xaiApiKey && !process.env.XAI_API_KEY) process.env.XAI_API_KEY = config.xaiApiKey;
   if (config.googleApiKey && !process.env.GOOGLE_API_KEY)
     process.env.GOOGLE_API_KEY = config.googleApiKey;
+  if (process.platform === "win32") {
+    const corePidFile = join2(config.neuraHome, "neura-core.pid");
+    try {
+      writeFileSync2(corePidFile, String(process.pid));
+      const cleanup = () => {
+        try {
+          unlinkSync(corePidFile);
+        } catch {
+        }
+      };
+      process.on("exit", cleanup);
+      process.on("SIGINT", cleanup);
+      process.on("SIGTERM", cleanup);
+    } catch (err) {
+      log6.warn("failed to write neura-core.pid", { err: String(err) });
+    }
+  }
   let store = null;
   const backupPath = join2(config.neuraHome, "memory-backup.json");
   if (config.pgDataPath) {