@aistastudio/myc 0.3.3 → 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.3 (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.
@@ -56,6 +58,7 @@ writing a config that silently won't start.
 ```bash
 ./dist/myc init                     # .myc/ + SQLite + migrations in this repo
 ./dist/myc wire                     # hooks for Claude Code / Codex / opencode / Kimi
+./dist/myc wire --scope user        # the same for agents in git worktrees (Claude Code's user layer)
 ./dist/myc ready                    # what can be picked up right now
 ./dist/myc remember "why X, not Y"  # record a fact or decision
 ./dist/myc recall "how retrieval works"
@@ -65,6 +68,25 @@ writing a config that silently won't start.
 
 Full command list: `./dist/myc --help`.
 
+**Agents in git worktrees.** `myc wire` writes into the project:
+`.claude/settings.json`, `.mcp.json`. An agent that orca starts in a git
+worktree of a nested repository (`~/orca/workspaces/<repo>/<branch>`) lives in
+the team's tree, where those files are not, even though `myc` itself finds the
+main copy's workspace from there. `myc wire --scope user` puts the same into
+Claude Code's user layer, which every session reads:
+`~/.claude/helpers/myc-hooks.mjs`, SessionStart/PreCompact/PostToolUse hooks and
+`Bash(myc <command>:*)` rules in `~/.claude/settings.json` (merged node by node;
+the hooks of orca, herdr and other tools stay byte for byte), the skill in
+`~/.claude/skills/myc`, and the MCP server through `claude mcp add --scope user`.
+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.
+
 ## Heavy commands take turns
 
 Several agents on one machine — in one tree or in neighbouring projects — each
@@ -97,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
@@ -266,6 +289,34 @@ myc code grep "<lit>"    exhaustive, every occurrence; --in <path> narrows it
 myc skeleton <file>      the file's API — 26× cheaper than reading it
 ```
 
+The file list is git's own (`git ls-files`, so `.gitignore` applies; a tree
+without git is walked, and the command says so). On top of any list,
+secret-named files are never indexed, whatever `.gitignore` says: `.env` and
+`.env.*` (templates like `.env.example` are indexed), `*.pem`, `*.key`,
+keystores, private SSH keys, `.npmrc`, `.netrc` and other credential files —
+`code index` counts them without naming them, and `code grep` refuses to read one.
+
+**Nested repositories and git worktrees.** A workspace can be an ecosystem: a
+root that is a git repository with independent repositories inside it (not
+submodules). It has one code index, built from the root — one row per file,
+paths like `messaging-server/server/src/x.ts`. From inside a nested
+repository every code command answers from that repository's part of the
+root index, with paths relative to the repository you are in; from the root
+the answers do not change. `myc code index` run inside a nested repository
+refreshes its part of the root index instead of building a second copy of the
+same files, and so does the background refresh. A git worktree — even one
+outside the workspace tree — is answered from the index of the main checkout:
+there is no index per branch. When the worktree is on another commit, or has
+uncommitted changes to tracked files, every answer carries
+`WARN code_index.worktree_divergent` naming both branches, because lines and
+spans may not match your files. `code grep` reads the worktree's files (the
+line numbers are yours, the owning symbols come from the index); `skeleton`
+shows the main copy's declarations when your copy differs from what the index
+saw, and says so. When nothing covers the repository, the hint is the command
+for the workspace root (`myc -C <root> code index`), not one that would build a
+duplicate. Anchors set from the root and from inside a repository are stored
+under different keys; `code symbol` reads both.
+
 Anchors tie knowledge to a span and follow the code as it moves; that half is
 language-agnostic and was verified on Python as well as TypeScript.
 

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;