@darkrei08/setup-ai 3.0.5 → 3.2.0

package/README.md

@@ -3,9 +3,9 @@
 Cross-OS installer for an AI coding toolchain. One command bootstraps
 [pi](https://pi.dev), [Codex](https://github.com/openai/codex),
 [Antigravity](https://antigravity.google), [opencode](https://opencode.ai),
-[herdr](https://herdr.dev), [gentle-ai](https://github.com/Gentleman-Programming/gentle-ai),
-[Engram](https://github.com/Gentleman-Programming/engram) memory, and the
-[Engineering Excellence](https://github.com/micio86dev/Engineering-Excellence)
+[herdr](https://herdr.dev),
+[gentle-ai](https://github.com/Gentleman-Programming/gentle-ai), and the
+[Engineering Excellence](https://github.com/darkrei08/Engineering-Excellence)
 skill — each via its **official, current** method for your OS.
 
 ## Quick start
@@ -26,7 +26,7 @@ npx @darkrei08/setup-ai --all                       # everything
 That's the whole thing. Three details worth knowing:
 
 - **Use the npm package above.** `npx github:darkrei08/setup-ai` also works, but many npm setups block git fetches (`EALLOWGIT`); the published package avoids that. Run it from any folder except the repo's own source dir.
-- **Windows PowerShell**: one command per line (no bash `\`). If node or git was just installed, open a **new terminal** so PATH refreshes.
+- **Windows PowerShell 7.3+**: one command per line (no bash `\`). If node or git was just installed, open a **new terminal** so PATH refreshes.
 - **What it does**: detects your OS and runs `setup-ai.sh` (macOS/Linux) or `setup-ai.ps1` (Windows). `--list` shows modules; menu keys: ↑/↓ move · Space toggle · `a` all · Enter.
 
 ### npm vs npx
@@ -47,12 +47,11 @@ For a one-time installer, `npx` is ideal — nothing is left behind.
 | Codex | `codex` | `brew install --cask codex` | `curl -fsSL https://chatgpt.com/codex/install.sh \| sh` | `irm https://chatgpt.com/codex/install.ps1 \| iex` |
 | pi | `pi` | `curl -fsSL https://pi.dev/install.sh \| sh` | same | `irm https://pi.dev/install.ps1 \| iex` |
 | herdr | `herdr` | `brew install herdr` | `curl -fsSL https://herdr.dev/install.sh \| sh` | `irm https://herdr.dev/install.ps1 \| iex` |
+| gentle-ai | `gentle-ai` / `gga` | `brew install gentleman-programming/tap/gentle-ai` | `curl -fsSL https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.sh \| bash` | `irm https://raw.githubusercontent.com/Gentleman-Programming/gentle-ai/main/scripts/install.ps1 \| iex` |
 | Go | `go` | `brew install go` | distro pkg | `winget install -e --id GoLang.Go` |
-| gentle-ai | `gentle-ai` | `brew install gentleman-programming/tap/gentle-ai` | `curl -fsSL .../scripts/install.sh \| bash` | `go install github.com/gentleman-programming/gentle-ai/v2/cmd/gentle-ai@latest` |
-| Engram | `engram` | `brew install gentleman-programming/tap/engram` | `go install github.com/Gentleman-Programming/engram/cmd/engram@latest` | same (go install) |
 | opencode | `opencode` | `brew install anomalyco/tap/opencode` | `curl -fsSL https://opencode.ai/install \| bash` | `npm i -g opencode-ai` |
 | cockpit-tools *(opt-in GUI)* | app | `brew install --cask cockpit-tools` | `.deb`/`.rpm`/`.AppImage` | `.msi` |
-| Engineering Excellence | skill | `npx skills@latest add micio86dev/Engineering-Excellence --agent <agent>` | same | same |
+| Engineering Excellence | skill | `npx skills@latest add darkrei08/Engineering-Excellence --agent <agent>` | same | same |
 
 ## Modules
 
@@ -60,30 +59,38 @@ Run `--list` to see them. Core modules install by default; optional ones
 (GUI apps) only via `--all` or an explicit `--only`.
 
 ```
-base node bun pi go dotenv ee pi-workflows herdr gentle-ai engram codex antigravity opencode [cockpit]
+base node bun pi go dotenv ee skills pi-workflows herdr gentle-ai codex antigravity opencode [cockpit]
 ```
 
-- **dotenv** is Linux-only (it runs vekexasia/dotenv's apt/pacman `setup_env.sh`).
+- **dotenv** is Linux-only (it runs vekexasia/dotenv's apt/pacman `setup_env.sh`); on Windows, explicit selection or `-All` logs and skips it.
 - **ee** installs the Engineering Excellence skill for every detected agent
-  (pi, claude, gemini, cursor, antigravity) via `npx skills add`.
-
-## Engram in pi (the gotcha)
-
-`gentle-engram` is an **in-process pi extension** that auto-starts `engram serve`.
-It therefore needs the **Engram Go binary on `PATH`** — if it's missing, the
-extension loads but silently does nothing (the "engram doesn't work in pi"
-symptom). The `engram` module installs the binary first, then:
-
-```bash
-pi install npm:gentle-engram
-pi install npm:pi-mcp-adapter      # optional MCP gateway
-pi-engram init
-# then RESTART pi, and verify:
-#   mem_current_project   mem_doctor   engram tui
-```
-
-MCP is only an optional gateway — the primary path for pi is the in-process
-extension, so don't rely on the MCP-only choice.
+  (pi, claude, gemini, cursor, antigravity, codex, opencode) via `npx skills add`.
+- **skills** installs vekexasia/dotenv's agent-skill stack on **every OS** via
+  `npx skills add` (dotenv itself is Linux-only): `herdr` (herdrdev/herdr);
+  `triage grill-me grilling wayfinder domain-modeling prototype research`
+  (mattpocock/skills); `typescript-advanced` (pedronauck/skills); `show-me`
+  (humanlayer/skills) — for every detected agent. `skills add --copy` is
+  idempotent, so it's safe alongside the Linux `dotenv` run.
+- **gentle-ai** installs the gentle-ai / `gga` ecosystem configurator, then runs
+  `gentle-ai install` — its own **interactive per-agent/per-IDE selector** (Pi,
+  Claude Code, Cursor, Codex, ...) that also wires each selected agent's **MCP**
+  servers, so the tools show up under `/mcp`. For pi it additionally installs the
+  first-class `gentle-pi` harness and `pi-mcp-adapter`, so pi reads gentle-ai in
+  its own MCP list. The interactive selector runs only with a real TTY;
+  non-interactive/CI runs log the exact `gentle-ai install` command instead of
+  hanging. Idempotent: safe to re-run.
+
+## pi workflows (pi-extensible-workflows)
+
+**Italiano** — Il modulo `pi-workflows` installa l'estensione pi per i workflow. Per
+installazione completa, pacchetti opzionali (`@piewf/cli`, `@piewf/herdr`), integrazione
+Herdr, picker `/workflow`, tool `workflow`, selezione modelli, ruoli/alias e Neovim, vedi
+la guida bilingue: [docs/pi-workflows-guide.md](docs/pi-workflows-guide.md).
+
+**English** — The `pi-workflows` module installs the pi workflows extension. For full
+install, optional packages (`@piewf/cli`, `@piewf/herdr`), Herdr integration, the
+`/workflow` picker, the `workflow` tool, model selection, roles/aliases, and Neovim, see
+the bilingual guide: [docs/pi-workflows-guide.md](docs/pi-workflows-guide.md).
 
 ## OpenCode Go inside pi
 

package/bin/setup-ai.mjs

@@ -3,10 +3,10 @@
 // AI Dev Suite — cross-OS launcher
 //
 // Detects the OS and runs the right installer script:
-//   win32            -> setup-ai.ps1  (via pwsh, falling back to powershell)
+//   win32            -> setup-ai.ps1  (via PowerShell 7.3+)
 //   darwin / linux   -> setup-ai.sh   (via bash)
 //
-// With no selection flag on an interactive terminal it shows a gentle-ai-style
+// With no selection flag on an interactive terminal it shows an arrow-key
 // arrow-key multi-select menu, then passes the chosen modules to the platform
 // script as --only. Zero runtime dependencies.
 //
@@ -29,21 +29,21 @@ const PKG_ROOT = join(__dirname, "..");
 // Canonical module list (mirrors the registries in setup-ai.sh / setup-ai.ps1).
 // core:false => optional (unchecked by default in the menu).
 const MODULES = [
-  { name: "base",         core: true,  desc: "System dev tools (git, gh, python, neovim, ...)" },
-  { name: "node",         core: true,  desc: "Node.js + npm@latest" },
+  { name: "base",         core: true,  desc: "System packages (build tools, git, gh, python, neovim, jq, imagemagick, go)" },
+  { name: "node",         core: true,  desc: "Node.js v22 + npm@latest (nvm on Unix, winget on Windows)" },
   { name: "bun",          core: true,  desc: "Bun runtime" },
   { name: "pi",           core: true,  desc: "pi.dev coding agent CLI" },
   { name: "go",           core: true,  desc: "Go toolchain" },
-  { name: "dotenv",       core: true,  desc: "vekexasia/dotenv dotfiles (Linux only)" },
-  { name: "ee",           core: true,  desc: "Engineering Excellence skill (all agents)" },
-  { name: "pi-workflows", core: true,  desc: "pi-extensible-workflows resolution fix" },
+  { name: "dotenv",       core: true,  desc: "vekexasia/dotenv dotfiles (Linux only: clones + runs setup_env.sh)" },
+  { name: "ee",           core: true,  desc: "Engineering Excellence skill (npx skills add, all detected agents)" },
+  { name: "skills",       core: true,  desc: "Upstream agent skills (herdr, grilling, research, typescript-advanced, show-me, ...) via npx skills add" },
+  { name: "pi-workflows", core: true,  desc: "pi-extensible-workflows (fix module resolution for pi extensions)" },
   { name: "herdr",        core: true,  desc: "herdr terminal multiplexer" },
-  { name: "gentle-ai",    core: true,  desc: "gentle-ai / gga + gentle-pi package" },
-  { name: "engram",       core: true,  desc: "Engram persistent memory for pi" },
+  { name: "gentle-ai",    core: true,  desc: "gentle-ai / gga ecosystem configurator (per-agent select + MCP) + gentle-pi" },
   { name: "codex",        core: true,  desc: "OpenAI Codex CLI" },
   { name: "antigravity",  core: true,  desc: "Google Antigravity CLI (agy)" },
-  { name: "opencode",     core: true,  desc: "opencode agent CLI" },
-  { name: "cockpit",      core: false, desc: "cockpit-tools desktop GUI (optional)" },
+  { name: "opencode",     core: true,  desc: "opencode agent CLI (opencode-ai)" },
+  { name: "cockpit",      core: false, desc: "cockpit-tools desktop GUI app (optional, CC BY-NC-SA)" },
 ];
 
 // dotenv is Linux-only; drop it from the Windows menu.
@@ -54,7 +54,11 @@ const argv = process.argv.slice(2);
 const has = (f) => argv.includes(f);
 const getVal = (f) => {
   const i = argv.indexOf(f);
-  if (i >= 0 && argv[i + 1]) return argv[i + 1];
+  if (i >= 0) {
+    const value = argv[i + 1];
+    if (value && !value.startsWith("-")) return value;
+    return null;
+  }
   const eq = argv.find((a) => a.startsWith(f + "="));
   return eq ? eq.split("=").slice(1).join("=") : null;
 };
@@ -74,16 +78,21 @@ function runScript(passArgs) {
   const child = spawn(cmd, cmdArgs, { stdio: "inherit" });
   child.on("error", (err) => {
     if (isWin && cmd === "pwsh") {
-      // Fall back to Windows PowerShell 5.
-      const ps1 = join(PKG_ROOT, "setup-ai.ps1");
-      const fb = spawn("powershell", ["-NoProfile", "-ExecutionPolicy", "Bypass", "-File", ps1, ...passArgs], { stdio: "inherit" });
-      fb.on("exit", (c) => process.exit(c ?? 0));
-      return;
+      console.error("PowerShell 7.3+ is required to run setup-ai.ps1. Install PowerShell 7.3 or newer and retry.");
+    } else {
+      console.error(`Failed to launch installer: ${err.message}`);
     }
-    console.error(`Failed to launch installer: ${err.message}`);
     process.exit(1);
   });
-  child.on("exit", (code) => process.exit(code ?? 0));
+  child.on("exit", (code, signal) => {
+    // A signal-terminated child reports code === null; that is a failure, not
+    // success, so never collapse it to 0.
+    if (code === null) {
+      console.error(`Installer terminated by signal ${signal ?? "unknown"}.`);
+      process.exit(1);
+    }
+    process.exit(code);
+  });
 }
 
 // Translate a chosen module list into the platform script's flag.
@@ -104,7 +113,7 @@ function toScriptArgs(mode, csv) {
   return [];
 }
 
-// ---- interactive multi-select (gentle-ai style) ---------------------------
+// ---- interactive multi-select ---------------------------------------------
 function interactiveMenu() {
   return new Promise((resolve, reject) => {
     const items = menuModules.map((m) => ({ ...m, checked: m.core }));
@@ -138,10 +147,17 @@ function interactiveMenu() {
     render(true);
 
     const cleanup = () => {
-      try { stdin.setRawMode(false); } catch { /* ignore */ }
+      let cleanupError = null;
+      try {
+        stdin.setRawMode(false);
+      } catch (err) {
+        cleanupError = err instanceof Error ? err : new Error(String(err));
+        console.error(`Could not restore terminal mode: ${cleanupError.message}`);
+      }
       stdin.pause();
       stdin.removeListener("data", onData);
       stdin.removeListener("end", onEnd);
+      return cleanupError;
     };
 
     // If stdin closes before a choice (e.g. npx consumed it), fall back instead
@@ -187,8 +203,16 @@ async function main() {
   if (has("--list")) return runScript(toScriptArgs("list"));
   if (has("--all")) return runScript(toScriptArgs("all"));
 
-  const only = getVal("--only");
-  if (only) return runScript(toScriptArgs("only", only));
+  const hasOnly = argv.some((arg) => arg === "--only" || arg.startsWith("--only="));
+  if (hasOnly) {
+    const only = getVal("--only");
+    if (!only || !only.trim()) {
+      console.error("--only requires a non-empty comma-separated module list.");
+      process.exitCode = 2;
+      return;
+    }
+    return runScript(toScriptArgs("only", only));
+  }
 
   if (has("--yes") || has("-y")) return runScript(toScriptArgs("yes"));
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@darkrei08/setup-ai",
-  "version": "3.0.5",
-  "description": "Cross-OS installer for an AI coding toolchain (pi, codex, antigravity, opencode, herdr, gentle-ai, engram, Engineering Excellence) with an interactive module menu.",
+  "version": "3.2.0",
+  "description": "Cross-OS installer for an AI coding toolchain (pi, codex, antigravity, opencode, herdr, gentle-ai/gga, Engineering Excellence) with an interactive module menu and per-agent MCP registration.",
   "type": "module",
   "bin": {
     "setup-ai": "bin/setup-ai.mjs"
@@ -32,7 +32,8 @@
     "opencode",
     "antigravity",
     "gentle-ai",
-    "engram",
+    "gga",
+    "mcp",
     "engineering-excellence",
     "setup"
   ],