@aistastudio/myc 0.3.4 → 0.3.5

package/README.md

@@ -31,9 +31,11 @@ Installation is one command:
 
 ```bash
 bun install -g @aistastudio/myc   # 3.20 MB, 10 files, no models pulled at install
-myc --version                     # myc 0.3.4 (schema 1)
+myc --version                     # myc 0.3.5 (schema 1)
 ```
 
+It runs on macOS and Linux; on Windows, use WSL.
+
 The embedding model is **not** downloaded during install. Semantic search is
 opt-in and explicit: `myc models fetch` (129 MB, ~7 s). Until then search is
 lexical and says so.
@@ -117,7 +119,8 @@ myc run: waiting for a 'heavy' slot (1/1 busy, 1 waiting ahead), waited 0.0s of
 
 A holder that dies — even by `SIGKILL` — frees its slot; a `myc run` nested
 inside another one runs at once, in its parent's slot. One slot per lane by
-default, `MYC_HEAVY_SLOTS=2` for two.
+default, `MYC_HEAVY_SLOTS=2` for two. myc does not load the project's `.env` or
+`bunfig.toml`: the command gets the caller's environment as is.
 
 **Agents don't have to remember it.** `myc wire --queue-hook` installs a Claude
 Code `PreToolUse` hook that rewrites a heavy Bash command into

package/bin/myc.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env bun
+#!/usr/bin/env -S bun --no-env-file --config=/dev/null
 /**
  * Точка входа npm-пакета @aistastudio/myc.
  *
@@ -10,6 +10,27 @@
  * Порядок важен: сначала проверка рантайма, и только потом ДИНАМИЧЕСКИЙ
  * импорт бандла. Статический импорт Node разрешил бы до первой строки тела
  * модуля — и мы бы снова упали на `bun:sqlite`, не успев ничего сказать.
+ *
+ * SHEBANG. Оба флага — про ЧУЖОЙ каталог: myc зовут хуки и MCP в каждом
+ * проекте пользователя, и cwd — это его проект. Без них Bun ДО первой строки
+ * этого файла грузит .env, .env.local, .env.<NODE_ENV> каталога в process.env
+ * (а `myc run` отдавал их команде: 2026-09-11 в cherry `bun test` получил
+ * 20 переменных EXPO_PUBLIC_* из .env worktree, которых в оболочке агента не
+ * было) и исполняет preload из ./bunfig.toml — happy-dom и моки тестов
+ * проекта внутри myc.
+ *   --no-env-file       .env* не грузятся;
+ *   --config=/dev/null  пустой конфиг вместо ./bunfig.toml. «Без конфига» у
+ *                       Bun нет: `--config=` (пусто) молча возвращает
+ *                       ./bunfig.toml, несуществующий путь — фатальная ошибка
+ *                       до старта, а /dev/null есть на любой POSIX. Глобальный
+ *                       ~/.bunfig.toml Bun читает по-прежнему: он не проектный.
+ * `env -S` нужен, чтобы флаги дошли до bun раздельно: ядро Linux отдаёт всё
+ * после интерпретатора ОДНИМ аргументом. -S есть в GNU coreutils ≥ 8.30 и в
+ * env macOS/BSD. На Windows такой shebang не исполним: шим `bun add -g` берёт
+ * `-S` за программу, а cmd-shim npm -S понимает, но Bun на Windows не
+ * открывает /dev/null — myc там только через WSL (говорит preflight.js).
+ * Запуск МИМО shebang (`bun …/myc.js`) флагов не получает; второй рубеж для
+ * `myc run` — callerEnv в src/commands/run.ts.
  */
 
 import { spawnSync } from "node:child_process";

package/bin/preflight.js

@@ -3,43 +3,66 @@
  * postinstall-проверка. Запускается тем рантаймом, который ставил пакет —
  * обычно это node, поэтому здесь снова голый JS без `bun:`.
  *
- * Зачем: shebang у bin/myc.js — `#!/usr/bin/env bun`, и если Bun в системе
- * нет вовсе, первая же попытка запустить `myc` даст `env: bun: No such file
- * or directory` (код 127) — сообщение, по которому нельзя понять ни причину,
- * ни что делать. Наша заглушка до этого не доживает: её просто некому
+ * Зачем: shebang у bin/myc.js — `#!/usr/bin/env -S bun --no-env-file
+ * --config=/dev/null` (зачем флаги — в шапке самого bin/myc.js), и если Bun в
+ * системе нет вовсе, первая же попытка запустить `myc` даст `env: bun: No such
+ * file or directory` (код 127) — сообщение, по которому нельзя понять ни
+ * причину, ни что делать. Наша заглушка до этого не доживает: её просто некому
  * выполнить. Значит сказать надо здесь, на установке.
  *
  * Установку НЕ роняем: пакет разложен правильно, не хватает только рантайма,
  * и это чинится `curl … | bash` без переустановки.
+ *
+ * WINDOWS — та же беда другим путём: там этот shebang не исполним вовсе, даже
+ * при установленном Bun. Шим `bun add -g` берёт `-S` за программу
+ * (`interpreter executable "-S" not found`), cmd-shim npm передаёт
+ * `--config=/dev/null`, а Bun на Windows такого файла не находит (`ENOENT …
+ * while reading config`). Оба отказа — до первой строки myc, и сказать
+ * человеку, что делать, можно только здесь. Установку тоже не роняем.
+ * Предел: `bun add -g` postinstall недоверенного пакета не запускает
+ * («Blocked 1 postinstall»), и эту рамку увидит только ставящий через npm —
+ * остальным о WSL говорит README.
  */
 
 import { spawnSync } from "node:child_process";
 
-if (typeof process.versions.bun !== "string" && !bunOnPath()) {
+if (process.platform === "win32") {
   process.stderr.write(
-    // Рамка собирается по ширине самой длинной строки, а не подгоняется
-    // руками: после переименования пакета `@myc/cli` -> `@aistastudio/myc`
-    // верхняя граница разъехалась, и это первое, что видит человек без Bun.
-    (() => {
-      const title = "@aistastudio/myc установлен, но запускаться пока не будет";
-      const body = [
-        "myc работает только на Bun (хранилище на bun:sqlite).",
-        "Bun в системе не найден.",
-        "",
-        "  curl -fsSL https://bun.sh/install | bash",
-        "",
-        "После этого: myc --version",
-      ];
-      const w = Math.max(title.length + 3, ...body.map((l) => l.length)) + 1;
-      const top = `  ┌─ ${title} ${"─".repeat(Math.max(0, w - title.length - 2))}┐`;
-      const mid = body.map((l) => `  │ ${l.padEnd(w)}│`);
-      const bot = `  └${"─".repeat(w + 1)}┘`;
-      return ["", top, ...mid, bot, ""].join("\n");
-    })(),
-
+    frame("@aistastudio/myc: Windows is not supported", [
+      "myc runs on macOS and Linux; on Windows use WSL.",
+      "The `myc` launcher will not start in cmd or PowerShell.",
+      "",
+      "  wsl --install",
+      "",
+      "Then, inside WSL: install Bun and @aistastudio/myc there.",
+    ]),
+  );
+} else if (typeof process.versions.bun !== "string" && !bunOnPath()) {
+  process.stderr.write(
+    frame("@aistastudio/myc установлен, но запускаться пока не будет", [
+      "myc работает только на Bun (хранилище на bun:sqlite).",
+      "Bun в системе не найден.",
+      "",
+      "  curl -fsSL https://bun.sh/install | bash",
+      "",
+      "После этого: myc --version",
+    ]),
   );
 }
 
+/**
+ * Рамка собирается по ширине самой длинной строки, а не подгоняется руками:
+ * после переименования пакета `@myc/cli` -> `@aistastudio/myc` верхняя граница
+ * разъехалась, и это первое, что видит человек без Bun.
+ */
+function frame(title, body) {
+  const w = Math.max(title.length + 3, ...body.map((l) => l.length)) + 1;
+  const top = `  ┌─ ${title} ${"─".repeat(Math.max(0, w - title.length - 2))}┐`;
+  const mid = body.map((l) => `  │ ${l.padEnd(w)}│`);
+  const bot = `  └${"─".repeat(w + 1)}┘`;
+  return ["", top, ...mid, bot, ""].join("\n");
+}
+
 function bunOnPath() {
   try {
     return spawnSync("bun", ["--version"], { stdio: "ignore" }).status === 0;