novahiz 0.11.5 → 0.11.7

package/CHANGELOG.md

@@ -5,6 +5,28 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## [Unreleased]
 
+## [0.11.7] - 2026-10-23
+
+### Fixed
+
+- **MCP Novahiz ne fonctionnent pas sur Linux** - OpenCode (en mode GUI/Desktop) ne
+  n'hérite pas du PATH du shell, donc `node` seul ne se résolvait pas pour les MCP
+  locaux (`novahiz-core`, `novahiz-gate`, `novahiz-docs`, `novahiz-search`,
+  `novahiz-scheduler`, `novahiz-scan`). L'installateur utilise maintenant le chemin
+  absolu de `node` (`process.execPath`) et propage le `PATH` de l'installateur via
+  `environment` à chaque MCP. Le MCP `dart` est omis si le Dart SDK n'est pas
+  présent (`which dart` / `where dart`).
+
+## [0.11.6] - 2026-10-23
+
+### Fixed
+
+- **Installer spawnSync arguments** - `spawnSync(...cmd, opts)` spread the
+  command array into separate positional arguments, causing
+  `ERR_INVALID_ARG_TYPE` on the options object during the catalog sync step
+  of `novahiz setup`. All 5 call sites now use
+  `spawnSync(cmd[0], cmd.slice(1), opts)`.
+
 ## [0.11.5] - 2026-10-23
 
 ### Fixed

package/README.md

@@ -4,7 +4,7 @@
 
 17 catégories, 94 skills, 13 gate rules, 8 MCP providers — tout déterministe, tout local, tout JSON.
 
-> **Version 0.11.4** — `npm install -g novahiz` pose le CLI, et le premier `novahiz` lancé termine l'installation (core puis extras). `CHANGELOG.md` et `scripts/` sont dans le tarball.
+> **Version 0.11.6** — `npm install -g novahiz` pose le CLI, et le premier `novahiz` lancé termine l'installation (core puis extras). `CHANGELOG.md` et `scripts/` sont dans le tarball.
 
 ```
 ┌──────────────────────────────────────────────────────────────────────────┐
@@ -43,8 +43,48 @@
 
 ### Option 1 — npm (recommandé)
 
+#### Linux
+
+Sur Linux, `/usr/local/lib/node_modules` appartient à `root`. Pour éviter d'utiliser `sudo` avec npm, configurez un préfixe dans votre dossier personnel :
+
+```bash
+mkdir -p ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
+source ~/.bashrc
+npm install -g novahiz
+novahiz setup
+novahiz doctor
+```
+
+Si vous préférez conserver l'installation système (nécessite `sudo`) :
+
+```bash
+sudo npm install -g novahiz
+sudo novahiz setup
+```
+
+#### Windows
+
+Sur Windows, aucune configuration préalable n'est nécessaire :
+
+```bash
+npm install -g novahiz
+novahiz setup
+novahiz doctor
+```
+
+#### macOS
+
+Sur macOS, aucune configuration particulière n'est nécessaire en général. Si vous obtenez une erreur de permissions sur `/usr/local/lib/node_modules`, utilisez la même méthode que sous Linux :
+
 ```bash
+mkdir -p ~/.npm-global
+npm config set prefix '~/.npm-global'
+echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
+source ~/.zshrc
 npm install -g novahiz
+novahiz setup
 novahiz doctor
 ```
 

package/install/install.mjs

@@ -505,7 +505,7 @@ async function main() {
     const cmd = cliSpawnArgs(home, "sync");
     if (cmd) {
       note("Building catalog (sync)");
-      const result = spawnSync(...cmd, {
+      const result = spawnSync(cmd[0], cmd.slice(1), {
         encoding: "utf8",
         env: { ...process.env, NOVAHIZ_HOME: home }
       });
@@ -534,7 +534,8 @@ async function main() {
         ? providersChoice
         : Boolean(flags["install-providers"]) || config?.providers?.autoInstall !== false;
     note("Checking dependencies");
-    const check = spawnSync(...cliSpawnArgs(home, "deps"), {
+    const checkArgs = cliSpawnArgs(home, "deps");
+    const check = spawnSync(checkArgs[0], checkArgs.slice(1), {
       encoding: "utf8",
       env: { ...process.env, NOVAHIZ_HOME: home }
     });
@@ -548,7 +549,8 @@ async function main() {
       note(autoInstall
         ? "Installing dependencies and providers (toolchain, MCP, skills, commands)"
         : "Installing core system dependencies (toolchain: python, uv — npm health)");
-      const result = spawnSync(...cliSpawnArgs(home, ...args), {
+      const installArgs = cliSpawnArgs(home, ...args);
+      const result = spawnSync(installArgs[0], installArgs.slice(1), {
         encoding: "utf8",
         env: { ...process.env, NOVAHIZ_HOME: home }
       });
@@ -744,6 +746,97 @@ async function main() {
       const agentsSkillsDir = join(homedir(), ".agents", "skills");
       const agentsSkillsDirLegacy = join(homedir(), ".config", ".agents", "skills");
 
+      // Le chemin absolu de node est essentiel : OpenCode (notamment en
+      // mode GUI/Desktop sur Linux) ne hérite pas du PATH du shell, donc
+      // `node` seul ne se résout pas. On utilise donc le chemin absolu du
+      // node qui lance l'installateur.
+      const nodeBin = process.execPath;
+      // On propage le PATH de l'installateur aux MCP locaux pour que `node`,
+      // `npx`, `dart` etc. soient trouvables même sans héritage du shell.
+      const mcpEnv = { PATH: process.env.PATH };
+
+      // Détermine si le Dart SDK est présent (nécessaire pour le MCP dart).
+      let hasDart = false;
+      try {
+        const dartCheck = spawnSync(
+          process.platform === "win32" ? "where" : "which",
+          ["dart"],
+          { encoding: "utf8", stdio: "pipe" }
+        );
+        hasDart = dartCheck.status === 0;
+      } catch {
+        // dart introuvable, le MCP dart sera omis
+      }
+
+      const mcp = {
+        "novahiz-docs": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "novahiz-docs", "index.mjs")],
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        "novahiz-search": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "lodestone", "index.mjs")],
+          "timeout": 120000,
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        // `novahiz-scheduler` is the local scheduler (mcp/clepsydre, zero npm
+        // dependency): it ships ready to run, no setup step.
+        "novahiz-scheduler": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "clepsydre", "index.mjs")],
+          "timeout": 120000,
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        "playwright": {
+          "type": "local",
+          // See playwrightBrowserFlag() in lib.mjs for the platform rule.
+          "command": ["npx", "-y", "@playwright/mcp@0.0.82", playwrightBrowserFlag()],
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        // Trio runtime (audit 2026-10-08) : novahiz_classify (27 outils dont
+        // la classification du pipeline), novahiz_gate (la porte que le skill
+        // novahiz-gate appelle) et scan (argus). Le transform du plugin les
+        // inscrit aussi, mais un transform arrive apres la resolution MCP ne
+        // lie jamais les serveurs — en config statique la connexion est
+        // garantie des l'installation. Le plugin voit editor.get(id) deja
+        // present et les saute : aucun doublon. timeout 120s = cold start
+        // argus (audit 2026-09-25 P2).
+        "novahiz-core": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "novahiz-tools", "index.mjs")],
+          "timeout": 120000,
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        "novahiz-gate": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "novahiz-gate", "index.mjs")],
+          "timeout": 120000,
+          "environment": mcpEnv,
+          "enabled": true
+        },
+        "novahiz-scan": {
+          "type": "local",
+          "command": [nodeBin, join(home, "mcp", "argus", "src", "cli.mjs")],
+          "timeout": 120000,
+          "environment": mcpEnv,
+          "enabled": true
+        }
+      };
+      if (hasDart) {
+        mcp["dart"] = {
+          "type": "local",
+          "command": ["dart", "mcp-server"],
+          "environment": mcpEnv,
+          "enabled": true
+        };
+      }
+
       const openCodeConfig = {
         "$schema": "https://opencode.ai/config.json",
         // T3: sans ce champ, adapters/opencode/instructions.md n'est lu par
@@ -758,64 +851,7 @@ async function main() {
         // (typescript-language-server, etc.) peuvent manquer — des entrees
         // mortes = exactement le probleme qu'on veut jamais livrer.
         "lsp": true,
-        "mcp": {
-          "novahiz-docs": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "novahiz-docs", "index.mjs")],
-            "enabled": true
-          },
-          "novahiz-search": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "lodestone", "index.mjs")],
-            "timeout": 120000,
-            "enabled": true
-          },
-          // `novahiz-scheduler` is the local scheduler (mcp/clepsydre, zero npm
-          // dependency): it ships ready to run, no setup step.
-          "novahiz-scheduler": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "clepsydre", "index.mjs")],
-            "timeout": 120000,
-            "enabled": true
-          },
-          "playwright": {
-            "type": "local",
-            // See playwrightBrowserFlag() in lib.mjs for the platform rule.
-            "command": ["npx", "-y", "@playwright/mcp@0.0.82", playwrightBrowserFlag()],
-            "enabled": true
-          },
-          "dart": {
-            "type": "local",
-            "command": ["dart", "mcp-server"],
-            "enabled": true
-          },
-          // Trio runtime (audit 2026-10-08) : novahiz_classify (27 outils dont
-          // la classification du pipeline), novahiz_gate (la porte que le skill
-          // novahiz-gate appelle) et scan (argus). Le transform du plugin les
-          // inscrit aussi, mais un transform arrive apres la resolution MCP ne
-          // lie jamais les serveurs — en config statique la connexion est
-          // garantie des l'installation. Le plugin voit editor.get(id) deja
-          // present et les saute : aucun doublon. timeout 120s = cold start
-          // argus (audit 2026-09-25 P2).
-          "novahiz-core": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "novahiz-tools", "index.mjs")],
-            "timeout": 120000,
-            "enabled": true
-          },
-          "novahiz-gate": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "novahiz-gate", "index.mjs")],
-            "timeout": 120000,
-            "enabled": true
-          },
-          "novahiz-scan": {
-            "type": "local",
-            "command": ["node", join(home, "mcp", "argus", "src", "cli.mjs")],
-            "timeout": 120000,
-            "enabled": true
-          }
-        },
+        "mcp": mcp,
         "skills": {
           "paths": [skillsDir]
         },
@@ -861,7 +897,7 @@ async function main() {
     const vaultCmd = cliSpawnArgs(home, "second-memory", "init");
     if (vaultCmd) {
       note("Creating the second-memory vault (structure + Obsidian plugins, ~10 downloads)...");
-      const vault = spawnSync(...vaultCmd, {
+      const vault = spawnSync(vaultCmd[0], vaultCmd.slice(1), {
         encoding: "utf8",
         timeout: 180000,
         env: { ...process.env, NOVAHIZ_HOME: home }
@@ -949,7 +985,7 @@ async function main() {
     const cleanupCmd = cliSpawnArgs(home, "sync");
     if (cleanupCmd) {
       note("Rebuilding catalog after cleanup (sync)");
-      const rebuild = spawnSync(...cleanupCmd, {
+      const rebuild = spawnSync(cleanupCmd[0], cleanupCmd.slice(1), {
         encoding: "utf8",
         env: { ...process.env, NOVAHIZ_HOME: home }
       });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "novahiz",
-  "version": "0.11.5",
+  "version": "0.11.7",
   "description": "Enforce AI agent skills before every file edit: prompt classifier, skill catalog, and pre-edit gate.",
   "type": "module",
   "license": "Apache-2.0",