@aistastudio/myc 0.3.4 → 0.3.6

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.6 (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.
@@ -80,10 +82,27 @@ Before anything else the helper checks, without starting myc, whether there is
 a workspace here (a git worktree is resolved through its main copy), and stays
 silent when there is none or the project wires myc itself: in a project without
 myc the hook costs one node start, and prime never arrives twice. Outside a
-workspace the MCP server offers zero tools and no instructions. The user's
-`statusLine` is never touched (it belongs to orca), and `--hook-mode replace`
-is refused here. The journal is `~/.myc/wire-user.json`; `myc unwire --scope
-user` restores the settings node by node and removes the MCP server.
+workspace the MCP server offers zero tools and no instructions. `--hook-mode
+replace` is refused here. The journal is `~/.myc/wire-user.json`; `myc unwire
+--scope user` restores the settings node by node and removes the MCP server.
+
+With `--status-line` the user layer also gets myc's status line, `myc
+statusline --scope user`: in a myc workspace — a git worktree of one included —
+it is the full line, outside one it prints nothing of its own. The line that was
+there (orca's, which prints nothing and posts the input to orca) is kept in the
+journal, not in our command, and gets the same stdin on every redraw, never
+waited on: orca takes a line whose command mentions its
+`agent-hooks/claude-statusline.sh` for its own and removes it when it
+uninstalls (a foreign line it leaves alone), so ours never carries the word
+`claude-statusline`. A
+project with its own myc line keeps it, and that line hands the input to the
+same recorded line. If another tool replaces the user line after wire, `myc
+doctor --hooks` says so; `myc wire --scope user --status-line` puts ours back
+and makes the new line the previous one, and `myc unwire --scope user` puts the
+previous line back byte for byte. `myc doctor --hooks` checks the whole user
+layer against the journal: myc's hook entries and rules still in
+`~/.claude/settings.json`, the helpers exactly what this build writes (a stale
+one is named with the build that wrote it), the status line, the MCP server.
 
 ## Heavy commands take turns
 
@@ -117,7 +136,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;