@engenty/wizards-runtime 0.7.9 → 0.7.11

package/bin/wizards.mjs

@@ -4,8 +4,8 @@
 //
 // The same file is two things. In the npm package `wizards` (`npx wizards`, `npm install -g
 // wizards`) it is the launcher, with nothing beside it but the installer (install.sh) and no
-// dependencies: on macOS and Linux it installs engenty wizards into ~/.engenty/wizards with that
-// installer (its own Node, the runtime @engenty/wizards-runtime, the `wizards` command), brings an
+// dependencies: it installs engenty wizards into ~/.engenty/wizards with that installer (on Windows
+// install.ps1: its own Node, the runtime @engenty/wizards-runtime, the `wizards` command), brings an
 // older install there up to its own version, and hands the command to it. In the runtime, which
 // the installer puts there, it is the command itself.
 //
@@ -27,17 +27,24 @@ const home = join(
   "wizards",
 );
 const runtime = join(home, "runtime");
-const wrapper = join(home, "bin", "wizards");
+const windows = process.platform === "win32";
+const wrapper = join(home, "bin", windows ? "wizards.cmd" : "wizards");
 /** The runtime's npm package. Up to 0.7.4 it was `wizards` itself; that name is the launcher now. */
 const RUNTIME = "@engenty/wizards-runtime";
 /** Whether this copy is the runtime, or the launcher without it. */
 const hasRuntime = existsSync(join(root, "apps", "runtime", "dist", "cli", "main.js"));
 /** The installer: beside the launcher, or in the runtime's built SPA. */
-const installer = [join(root, "install.sh"), join(root, "apps", "web", "dist", "install.sh")].find(
-  (file) => existsSync(file),
-);
+const installerName = windows ? "install.ps1" : "install.sh";
+const installer = [
+  join(root, installerName),
+  join(root, "apps", "web", "dist", installerName),
+].find((file) => existsSync(file));
 // uninstall: never installs or hands over first; the install it takes away may no longer run.
 const RUN_HERE = ["help", "validate", "mcp", "uninstall"];
+/** The installer's line, as a person types it here. */
+const installLine = windows
+  ? "  irm https://engenty.ai/install.ps1 | iex\n"
+  : "  curl -fsSL https://engenty.ai/install.sh | bash\n";
 const tilde = (path) =>
   path.startsWith(homedir() + sep) ? `~${path.slice(homedir().length)}` : path;
 
@@ -112,7 +119,12 @@ function isInstall() {
 function terminalEnv() {
   const env = {};
   for (const [key, value] of Object.entries(process.env)) {
-    if (!key.startsWith("npm_") && !["INIT_CWD", "NODE", "COLOR"].includes(key)) {
+    // PATH comes after, once: Windows calls it Path, and two of them would leave one to chance.
+    if (
+      !key.startsWith("npm_") &&
+      !["INIT_CWD", "NODE", "COLOR"].includes(key) &&
+      key.toUpperCase() !== "PATH"
+    ) {
       env[key] = value;
     }
   }
@@ -128,7 +140,10 @@ function install(version, quiet) {
   if (!installer) {
     return false;
   }
-  const result = spawnSync("bash", [installer, "--no-setup"], {
+  const [shell, ...shellArgs] = windows
+    ? ["powershell.exe", "-NoProfile", "-ExecutionPolicy", "Bypass", "-File", installer, "-NoSetup"]
+    : ["bash", installer, "--no-setup"];
+  const result = spawnSync(shell, shellArgs, {
     // A command whose output is read (validate --json, mcp) keeps its stdout to itself.
     stdio: ["ignore", quiet ? 2 : "inherit", "inherit"],
     env: {
@@ -161,10 +176,29 @@ function runs() {
   }
 }
 
+/**
+ * The installed command with these arguments. On Windows its Node and script, which is what
+ * wizards.cmd runs: a .cmd file starts only through cmd.exe, which would read the arguments again.
+ */
+function installedCommand(argv) {
+  if (!windows) {
+    return [wrapper, argv];
+  }
+  const script = join(runtime, "current", "node_modules", RUNTIME, "bin", "wizards.mjs");
+  return [join(home, "tools", "node", "node.exe"), [script, ...argv]];
+}
+
+/** Runs the installed command with these arguments, waiting for it. */
+function installedRun(argv, quiet) {
+  const [file, all] = installedCommand(argv);
+  spawnSync(file, all, { stdio: ["ignore", quiet ? 2 : "inherit", "inherit"], env: terminalEnv() });
+}
+
 /** Runs the installed command with these arguments; its exit code. */
 function handOver() {
   return new Promise((done) => {
-    const child = spawn(wrapper, args, { stdio: "inherit", env: terminalEnv() });
+    const [file, argv] = installedCommand(args);
+    const child = spawn(file, argv, { stdio: "inherit", env: terminalEnv() });
     // Ctrl-C reaches the installed command as well (same terminal); this one waits for it.
     process.on("SIGINT", () => undefined);
     process.on("SIGTERM", () => child.kill("SIGTERM"));
@@ -184,19 +218,6 @@ if (command === "version") {
 const own = versionOf(root) || "0.0.0";
 const quiet = RUN_HERE.includes(command);
 const checkout = existsSync(join(root, "pnpm-workspace.yaml"));
-// Windows has no installer yet, and the setup, the service and the AI clients are written for
-// macOS and Linux: it says so instead of half working. What needs no install still runs.
-if (process.platform === "win32" && !checkout && !(hasRuntime && RUN_HERE.includes(command))) {
-  console.error(
-    "engenty wizards for Windows is coming soon.\n\n" +
-      "Until then it runs in WSL (Windows Subsystem for Linux). In PowerShell:\n\n" +
-      "  wsl --install\n\n" +
-      "then, in the Ubuntu terminal that opens:\n\n" +
-      "  curl -fsSL https://engenty.ai/install.sh | bash\n\n" +
-      "https://engenty.ai/docs/user/install\n",
-  );
-  process.exit(1);
-}
 if (isInstall() && !hasRuntime) {
   // The launcher in the install's place: an update of 0.7.4 or older fetched `wizards`, the
   // runtime's name then, and its next start switched to it. The installer it carries brings the
@@ -217,7 +238,7 @@ if (isInstall() && !hasRuntime) {
   }
   process.exit(await handOver());
 }
-const fromNpm = process.platform !== "win32" && !checkout && !isInstall();
+const fromNpm = !checkout && !isInstall();
 if (fromNpm && command === "uninstall" && !hasRuntime) {
   // The install's own uninstall takes it away; it never updates first. An install the update
   // left without its runtime gets it back (above, in the installed command) and then uninstalls.
@@ -235,15 +256,18 @@ if (
   const installed = installedVersion();
   if (!installed || older(installed, own)) {
     const running = installed && runs();
-    if (install(own, quiet)) {
-      // What runs is still the old version: it starts again as the new one.
-      if (running) {
-        spawnSync(wrapper, ["restart"], {
-          stdio: ["ignore", quiet ? 2 : "inherit", "inherit"],
-          env: terminalEnv(),
-        });
-      }
-    } else if (hasRuntime && currentNode && !installed) {
+    // Windows keeps the files of a running program locked: the runtime stops for the update.
+    if (running && windows) {
+      installedRun(["stop"], quiet);
+    }
+    const done = install(own, quiet);
+    // What ran is still the old version: it starts again as the new one.
+    if (running && windows) {
+      installedRun(["start", "--background", "--no-open"], quiet);
+    } else if (running && done) {
+      installedRun(["restart"], quiet);
+    }
+    if (!done && hasRuntime && currentNode && !installed) {
       console.error(
         `The install into ${tilde(home)} failed; this time engenty wizards runs from npm.\n`,
       );
@@ -259,14 +283,14 @@ if (
   if (!hasRuntime) {
     console.error(
       `engenty wizards couldn’t be installed into ${tilde(home)}. The installer on its own:\n\n` +
-        "  curl -fsSL https://engenty.ai/install.sh | bash\n",
+        installLine,
     );
     process.exit(1);
   }
 }
 if (!currentNode && command === "uninstall") {
   // The install's own Node, if it is still there, runs this copy's uninstall.
-  const node = join(home, "tools", "node", "bin", "node");
+  const node = join(home, "tools", "node", windows ? "node.exe" : "bin/node");
   const result = existsSync(node)
     ? spawnSync(node, [fileURLToPath(import.meta.url), ...args], { stdio: "inherit" })
     : null;
@@ -276,7 +300,7 @@ if (!currentNode) {
   console.error(
     `engenty wizards needs Node.js 24.11 or newer. This is ${process.version}.\n` +
       "The installer brings its own and leaves yours alone:\n\n" +
-      "  curl -fsSL https://engenty.ai/install.sh | bash\n",
+      installLine,
   );
   process.exit(1);
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@engenty/wizards-runtime",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "description": "Make a wish. Get your wizard. It guides you step by step. Let AI do the work. Runs on your machine, on the AI subscription you already have. The runtime, which `npx wizards` installs.",
-  "license": "FSL-1.1-MIT",
+  "license": "FSL-1.1-MIT AND CC-BY-4.0",
   "homepage": "https://engenty.ai",
   "repository": {
     "type": "git",
@@ -15,15 +15,13 @@
   "engines": {
     "node": ">=24.11"
   },
-  "os": [
-    "darwin",
-    "linux"
-  ],
   "files": [
     "apps",
     "bin",
     "modules",
-    "plugin"
+    "plugin",
+    "LICENSE-FIGURES",
+    "TRADEMARKS.md"
   ],
   "dependencies": {
     "@ai-sdk/anthropic": "4.0.54",
@@ -50,6 +48,7 @@
     "@turbodocx/html-to-docx": "1.23.1",
     "ai": "7.0.102",
     "aws4fetch": "1.0.20",
+    "cross-spawn": "7.0.6",
     "drizzle-orm": "0.45.3",
     "effect": "4.0.0-beta.59",
     "exceljs": "4.4.0",

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "wizards",
   "displayName": "engenty wizards",
-  "version": "0.7.9",
+  "version": "0.7.11",
   "description": "Build page-by-page AI wizards that people open on a shared link — designed, tested and published from Claude Code — run your published ones in the chat, and keep them in a pane beside it.",
   "author": {
     "name": "engenty"

package/plugin/hooks/engenty.ts

@@ -1,3 +1,4 @@
+// SPDX-License-Identifier: CC-BY-4.0
 /**
  * The flat engenties of the studio (apps/web/src/engenty/engenty.tsx) at rest, as one SVG
  * string per kind: the same bodies, the one eye, no animation. The fills are the studio's
@@ -38,7 +39,7 @@ const stroke = (d: string, color: string, width: number, opacity: number) =>
 const KINDS: Record<string, Kind> = {
   round: {
     fill: FILL.cobalt,
-    body: "M60 22 Q96 26 96 62 Q96 96 60 100 Q24 96 24 62 Q24 26 60 22 Z",
+    body: "M60 22 C65.2 22 71.2 24 75.8 26 C80.2 28 84 30.7 87 34 C90 37.3 92.2 41.3 93.8 46 C95.2 50.7 96 56.8 96 62 C96 67.2 95.2 72.7 93.8 77.1 C92.2 81.5 90 85.3 87 88.5 C84 91.7 80.2 94.2 75.8 96.1 C71.2 98 65.2 100 60 100 C54.8 100 48.8 98 44.2 96.1 C39.8 94.2 36 91.7 33 88.5 C30 85.3 27.8 81.5 26.2 77.1 C24.8 72.7 24 67.2 24 62 C24 56.8 24.8 50.7 26.2 46 C27.8 41.3 30 37.3 33 34 C36 30.7 39.8 28 44.2 26 C48.8 24 54.8 22 60 22 Z",
     over: `<circle cx="97" cy="34" r="6" fill="${FILL.cobalt}" opacity="0.5"/><circle cx="106" cy="24" r="3.5" fill="${FILL.cobalt}" opacity="0.35"/>`,
     eye: { ex: 68, ey: 58, r: 8, ink: "oklch(18% 0.08 260)" },
     shadow: { cy: 108, rx: 26 },
@@ -47,7 +48,7 @@ const KINDS: Record<string, Kind> = {
     fill: FILL.amber,
     body: "M60 16 Q90 34 90 66 Q90 96 60 98 Q30 96 30 66 Q30 34 60 16 Z",
     eye: { ex: 60, ey: 56, r: 8, ink: "oklch(30% 0.10 60)" },
-    after: stroke("M48 76 Q54 72 60 76 Q66 80 72 76", "oklch(30% 0.10 55)", 2.6, 1),
+    after: stroke("M49 75 C54 78 64 78.5 71 71.4", "oklch(30% 0.10 55)", 2.6, 1),
     shadow: { cy: 106, rx: 24 },
   },
   dome: {