mu-agent 0.2.5 → 0.2.6

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 ## [Unreleased]
 
+## [0.2.6] - 2026-10-24
+
+**0.2.6 shows the note that Laya was replaced when a person sends a message, keeps mude 1.0 local only when it's installed again, and stops `mu doctor` failing on a machine without Chrome.**
+
+### Fixed
+
+- The `laya_removed` notice waits for a person. In 0.2.5 the desktop backend's health check of mu (a session that never gets a prompt) was the first session with a UI: it took Laya out of mu.json and got the notice about 3 s after the app started, so nobody saw it. mu.json still loses Laya at the first session start with a terminal or the desktop app, but the notice is now kept in `<agentDir>/mu/notices.json` (`layaRemoved: { judge, from }`) and said at the first message a person sends, in that session or a later one: `judge.notice`, then the line, and the entry is removed. pi's `input` event is that message; mu's own commands (`/goal`, `/permissions`, `/mu …`), which pi runs before it, and messages an extension sends don't count. A session that gets no message leaves the notice where it is, and `mu --print` and json mode still change nothing. `MU_JUDGE=laya` leaves the same notice at the start of each session that has it. The free Jev notice now writes its day beside other entries in notices.json instead of replacing the file. A mu.json that 0.2.5 already updated has no notice left to show.
+- `mu judge mude install` without `--local-only` or `--with-fallback` keeps the current setting when mude 1.0 is already the judge (as `enable` does), instead of putting Jev back behind it.
+- `mu judge model add`: a 401 without `HF_TOKEN` says the model doesn't exist or is private or gated, and to check the name, since Hugging Face answers both the same way.
+- `mu doctor` and `/doctor` mark a missing Chrome, Chromium, Edge or Brave as optional (`--`) instead of something to fix, so `mu doctor` exits 0 when everything else is set up. `mu --help` lines fit in 100 columns.
+
 ## [0.2.5] - 2026-10-24
 
 **0.2.5 removes Laya from mu's built-in judges. A configuration that still names it switches to mude 1.0 or Jev on its own.**

package/README.md

@@ -27,7 +27,7 @@ mu is built on [pi](https://github.com/earendil-works/pi). It hands the small qu
 
 ## Choose a judge
 
-Out of the box, the judge is Jev 1.13, TypeSafe's hosted judge model, free on OpenCode Zen for a limited time and with no key needed. What it judges goes to OpenCode, which doesn't train on it, and mu reminds you of that once a day. To send nothing anywhere, run `mu setup --judge off` (or choose "Not now" when `mu setup` asks): no decision point asks a judge, and mu's features keep working on their rules. Or, on a Mac with Apple silicon, use mude 1.0 with `--local-only`.
+Out of the box, the judge is Jev 1.13, TypeSafe's hosted judge model, free on OpenCode Zen for a limited time and with no key needed. What it judges goes to OpenCode, which doesn't train on it, and mu reminds you of that once a day. To send nothing anywhere, run `mu setup --judge off` (or choose "Not now" when `mu setup` asks): no decision point asks a judge, and mu's features fall back to their own rules. Or, on a Mac with Apple silicon, use mude 1.0 with `--local-only`.
 
 - **Jev** (hosted): set `TYPESAFE_API_KEY` (TypeSafe), `MU_JUDGE_OPENROUTER_API_KEY` (Jev on OpenRouter), `AI_GATEWAY_API_KEY` (Vercel AI Gateway), `OPENCODE_API_KEY` (OpenCode Zen) or `CLOUDFLARE_API_KEY` with `CLOUDFLARE_ACCOUNT_ID` (Cloudflare Workers AI) in your environment, or add it to `~/.mu/.env` as `KEY=value`. `mu setup` asks for a key and writes it there. mu reads that file as data, never prints it and starts using the key automatically.
 - **Another classifier** from pi's catalog: `/mu judge classifier:<provider>/<model>`, for example Cloudflare's Clef (`clef`, `clef-flash`) or a System One model on OpenRouter, with that provider's key.

package/judge/dist/mude.js

@@ -1071,7 +1071,7 @@ async function resolveModel(ref, options = {}) {
     }
     if (response.status === 401 || response.status === 403) {
       throw new ModelError(
-        `Hugging Face won't show ${ref.repo} (${response.status}): it's private or gated. Accept its terms on huggingface.co, set HF_TOKEN, then add it again`,
+        response.status === 401 && !options.token ? `Couldn't open ${ref.repo} on Hugging Face (401): it doesn't exist, or it's private or gated. Check the name; for a gated model, accept its terms on huggingface.co, set HF_TOKEN, then add it again` : `${ref.repo} is private or gated on Hugging Face (${response.status}). Accept its terms on huggingface.co, set HF_TOKEN, then add it again`,
         "access"
       );
     }
@@ -1477,10 +1477,11 @@ function installLocalOnly(ctx, args) {
   if (args.includes("--with-fallback")) return false;
   try {
     const value = JSON.parse(readFileSync7(ctx.paths.install, "utf8"));
-    return typeof value === "object" && value !== null && "localOnly" in value && value.localOnly === true;
+    if (typeof value === "object" && value !== null && "localOnly" in value) return value.localOnly === true;
   } catch {
-    return false;
   }
+  const current = judgeSetting(ctx.files, pkgOf(ctx).judge.name);
+  return current.enabled && current.localOnly;
 }
 function startedAt(pid) {
   try {
@@ -1961,7 +1962,7 @@ ${USAGE2}`, "usage");
       else out = humanOut(write, tty, each2.pkg);
       out.step(
         "model",
-        `${record2.repo} @ ${record2.revision.slice(0, 7)} (${gb2(record2.bytes)} GB) is the decision model ${record2.id}. It runs its own server code (${SERVER_FILE}) on this Mac: add only models you trust.`
+        `Adding ${record2.repo} @ ${record2.revision.slice(0, 7)} (${gb2(record2.bytes)} GB) as ${record2.id}. It runs its own server code (${SERVER_FILE}) on this Mac: add only models you trust.`
       );
       await install(each2, out, flags, mudePaths(home));
       out.status(await status(each2));

package/judge/dist/setup.js

@@ -1439,10 +1439,11 @@ function installLocalOnly(ctx, args) {
   if (args.includes("--with-fallback")) return false;
   try {
     const value = JSON.parse(readFileSync7(ctx.paths.install, "utf8"));
-    return typeof value === "object" && value !== null && "localOnly" in value && value.localOnly === true;
+    if (typeof value === "object" && value !== null && "localOnly" in value) return value.localOnly === true;
   } catch {
-    return false;
   }
+  const current = judgeSetting(ctx.files, pkgOf(ctx).judge.name);
+  return current.enabled && current.localOnly;
 }
 function startedAt(pid) {
   try {

package/judge/manifest.json

@@ -270,7 +270,7 @@
 			},
 			"summary": {
 				"zh": "任务进行中你又发来一句话：判断是在下一步就带进工作，还是等这一轮做完再处理。判定最多等 1.5 秒；没有判定时，消息按你发送的方式送达。",
-				"en": "For a message you send while the agent is working: bring it into the work at the next step, or hold it until the run is done. mu waits up to 1.5 seconds for the verdict; without one, the message goes as you sent it.",
+				"en": "For a message you send while the agent is working: deliver it at the next step, or hold it until the run is done. mu waits up to 1.5 seconds for the verdict; without one, the message goes as you sent it.",
 				"zh-TW": "任務進行中你又傳來一則訊息：判斷是在下一步就帶進工作，還是等這一輪做完再處理。判定最多等 1.5 秒；沒有判定時，訊息照你傳送的方式送達。",
 				"ja-JP": "エージェントの作業中に送ったメッセージを、次のステップで作業に取り込むか、実行が終わるまで待たせるかを判定します。判定は最大 1.5 秒待ち、判定がなければメッセージは送ったとおりに届きます。",
 				"ko-KR": "에이전트가 작업하는 중에 보낸 메시지를 다음 단계에서 작업에 반영할지, 실행이 끝날 때까지 기다리게 할지 판정합니다. 판정은 최대 1.5초 기다리며, 판정이 없으면 메시지는 보낸 그대로 전달됩니다.",
@@ -1381,7 +1381,7 @@
 			},
 			"summary": {
 				"zh": "上下文预算、后台命令结束等事件出现时，判断该现在告诉模型、稍后再说，还是不必说。默认是影子模式：判定只记录，事件按各自的规则投递，后台命令结束和上下文预算都是立刻告知。",
-				"en": "For events such as the context budget or a background job's end: tell the model now, later or not at all. In shadow by default: the verdict is only logged, and each event is delivered by its own rule: right away for a job's end and the context budget.",
+				"en": "For events such as the context budget or a background job's end: tell the model now, later or not at all. In shadow by default: the verdict is only logged, and each event is delivered by its own rule (right away for a job's end and the context budget).",
 				"zh-TW": "上下文預算、背景工作結束這類事件出現時，判斷該現在告訴模型、晚點再說，還是不必說。預設為影子模式：判定只記錄下來，事件各按自己的規則送達；背景工作結束和上下文預算都是立刻告知。",
 				"ja-JP": "コンテキスト予算やバックグラウンドジョブの終了などのイベントを、モデルにすぐ伝えるか、後で伝えるか、伝えないかを判定します。既定ではシャドーモードです。判定は記録するだけで、各イベントはそれぞれのルールで届けます。ジョブの終了とコンテキスト予算の場合は、すぐに届けます。",
 				"ko-KR": "컨텍스트 예산이나 백그라운드 작업 종료 같은 이벤트를 모델에게 지금 알릴지, 나중에 알릴지, 알리지 않을지 정합니다. 기본값은 섀도 모드입니다. 판정은 기록만 하고 각 이벤트는 자체 규칙에 따라 전달되는데, 작업 종료와 컨텍스트 예산은 바로 알립니다.",

package/judge/mu/index.js

@@ -15046,7 +15046,7 @@ var require_snapshot_recorder = __commonJS({
   "node_modules/undici/lib/mock/snapshot-recorder.js"(exports, module) {
     "use strict";
     var { writeFile: writeFile7, readFile: readFile6, mkdir: mkdir2 } = __require("node:fs/promises");
-    var { dirname: dirname14, resolve: resolve15 } = __require("node:path");
+    var { dirname: dirname13, resolve: resolve15 } = __require("node:path");
     var { setTimeout: setTimeout2, clearTimeout: clearTimeout2 } = __require("node:timers");
     var { InvalidArgumentError, UndiciError } = require_errors();
     var { hashId, isUrlExcludedFactory, normalizeHeaders, createHeaderFilters } = require_snapshot_utils();
@@ -15292,7 +15292,7 @@ var require_snapshot_recorder = __commonJS({
           throw new InvalidArgumentError("Snapshot path is required");
         }
         const resolvedPath = resolve15(path);
-        await mkdir2(dirname14(resolvedPath), { recursive: true });
+        await mkdir2(dirname13(resolvedPath), { recursive: true });
         const data = Array.from(this.#snapshots.entries()).map(([hash, snapshot2]) => ({
           hash,
           snapshot: snapshot2
@@ -37933,7 +37933,7 @@ var helpSectionsEn = () => [
   },
   {
     title: "Judgment kernel",
-    intro: `esc skips the wait for the judge's reading of a message; ${(0, import_pi_coding_agent5.keyText)("app.tools.expand")} shows the full answers behind a verdict.`,
+    intro: `While the judge reads a message, esc skips the wait; ${(0, import_pi_coding_agent5.keyText)("app.tools.expand")} shows the full answers behind a verdict.`,
     rows: [
       [
         "/mu judge <judges>",
@@ -38235,7 +38235,12 @@ function registerCommands(runtime, roots) {
           "decisions",
           `default mode ${engine.getMode("*")}. Change it with /mu mode default <off|shadow|active>`
         ],
-        [ok(Boolean(chrome)), "browser", chrome ?? browserAdvice(browserHost)],
+        // Only mu's browser needs one: without it the rest of mu works.
+        [
+          chrome ? "ok  " : "--  ",
+          "browser",
+          chrome ?? `optional, for mu's browser. ${browserAdvice(browserHost)}`
+        ],
         [
           "--  ",
           "browse",
@@ -39940,9 +39945,30 @@ last update failed: ${lastFailure}` : text7, "info");
   });
 }
 
+// packages/kyrn-judge/src/extension/features/notices.ts
+import { readFileSync as readFileSync13 } from "node:fs";
+import { join as join23 } from "node:path";
+function noticesFile(agentDir) {
+  return join23(agentDir, "mu", "notices.json");
+}
+function readNotices(file) {
+  if (!file) return {};
+  try {
+    const value = JSON.parse(readFileSync13(file, "utf8"));
+    return typeof value === "object" && value !== null && !Array.isArray(value) ? value : {};
+  } catch {
+    return {};
+  }
+}
+function writeNotice(file, key, value) {
+  const notices = { ...readNotices(file), version: 1 };
+  if (value === void 0) delete notices[key];
+  else notices[key] = value;
+  writeFileAtomic(file, `${JSON.stringify(notices, null, "	")}
+`);
+}
+
 // packages/kyrn-judge/src/extension/features/free-jev.ts
-import { mkdirSync as mkdirSync11, readFileSync as readFileSync13, writeFileSync as writeFileSync9 } from "node:fs";
-import { dirname as dirname5, join as join23 } from "node:path";
 var ENDED = /* @__PURE__ */ new Map([
   ["auth", "paid"],
   ["payment_required", "paid"],
@@ -39953,25 +39979,18 @@ var today = () => {
   return `${now.getFullYear()}-${String(now.getMonth() + 1).padStart(2, "0")}-${String(now.getDate()).padStart(2, "0")}`;
 };
 function saidOn(file) {
-  if (!file) return void 0;
-  try {
-    const value = JSON.parse(readFileSync13(file, "utf8"));
-    return typeof value.freeJev === "string" ? value.freeJev : void 0;
-  } catch {
-    return void 0;
-  }
+  const day = readNotices(file).freeJev;
+  return typeof day === "string" ? day : void 0;
 }
 function markSaid(file, day) {
   if (!file) return;
   try {
-    mkdirSync11(dirname5(file), { recursive: true });
-    writeFileSync9(file, `${JSON.stringify({ version: 1, freeJev: day }, null, "	")}
-`);
+    writeNotice(file, "freeJev", day);
   } catch {
   }
 }
 function registerFreeJevNotice(runtime, roots) {
-  const file = roots ? join23(roots.agentDir, "mu", "notices.json") : void 0;
+  const file = roots ? noticesFile(roots.agentDir) : void 0;
   let inUseSaid = false;
   let endSaid = false;
   const tell = (code, message, reason) => {
@@ -41407,7 +41426,7 @@ var hiveRelate = defineDecision({
 });
 
 // packages/kyrn-judge/src/hive/board.ts
-import { appendFileSync as appendFileSync3, closeSync as closeSync2, fstatSync, mkdirSync as mkdirSync12, openSync as openSync2, readSync as readSync2 } from "node:fs";
+import { appendFileSync as appendFileSync3, closeSync as closeSync2, fstatSync, mkdirSync as mkdirSync11, openSync as openSync2, readSync as readSync2 } from "node:fs";
 import { join as join24 } from "node:path";
 var BOARD = "board.jsonl";
 var DELIVERIES = "deliveries.jsonl";
@@ -41450,7 +41469,7 @@ var Board = class {
   offset = 0;
   constructor(dir) {
     this.dir = dir;
-    mkdirSync12(dir, { recursive: true });
+    mkdirSync11(dir, { recursive: true });
   }
   post(note2) {
     appendFileSync3(join24(this.dir, BOARD), `${JSON.stringify(note2)}
@@ -41643,7 +41662,7 @@ var swarmRouting = defineDecision({
 
 // packages/kyrn-judge/src/swarm/patches.ts
 import { randomBytes } from "node:crypto";
-import { mkdirSync as mkdirSync13, readFileSync as readFileSync14, writeFileSync as writeFileSync10 } from "node:fs";
+import { mkdirSync as mkdirSync12, readFileSync as readFileSync14, writeFileSync as writeFileSync9 } from "node:fs";
 import { rm as rm2 } from "node:fs/promises";
 import { join as join26 } from "node:path";
 
@@ -41651,7 +41670,7 @@ import { join as join26 } from "node:path";
 import { spawn as spawn5 } from "node:child_process";
 import { existsSync as existsSync11 } from "node:fs";
 import { chmod, copyFile, lstat, mkdir, readdir, readFile, readlink, rm, symlink, writeFile } from "node:fs/promises";
-import { dirname as dirname6, join as join25 } from "node:path";
+import { dirname as dirname5, join as join25 } from "node:path";
 function gitArgs(args, platform = process.platform) {
   return [
     "-c",
@@ -41757,7 +41776,7 @@ async function copyUntracked(from, to, paths, maxBytes) {
     if (path.endsWith("/")) continue;
     try {
       const stat = await lstat(join25(from, path));
-      await mkdir(dirname6(join25(to, path)), { recursive: true });
+      await mkdir(dirname5(join25(to, path)), { recursive: true });
       if (stat.isSymbolicLink()) await symlink(await readlink(join25(from, path)), join25(to, path));
       else if (!stat.isFile()) continue;
       else if (stat.size > maxBytes) {
@@ -41895,8 +41914,8 @@ async function removeWorktree(run2, worktree) {
 }
 var markerPath = (dir) => `${dir}.json`;
 async function writeMarker(marker) {
-  await mkdir(dirname6(marker.dir), { recursive: true });
-  await chmod(dirname6(marker.dir), 448).catch(() => void 0);
+  await mkdir(dirname5(marker.dir), { recursive: true });
+  await chmod(dirname5(marker.dir), 448).catch(() => void 0);
   await writeFile(markerPath(marker.dir), JSON.stringify(marker), { mode: 384 });
 }
 var RUN_DIR = /^kyrn-swarm-[\w-]+$/;
@@ -41947,7 +41966,7 @@ var PatchStore = class {
     do
       id = `p-${randomBytes(3).toString("hex")}`;
     while (this.records.has(id));
-    mkdirSync13(dir, { recursive: true, mode: 448 });
+    mkdirSync12(dir, { recursive: true, mode: 448 });
     const record4 = {
       ...details,
       id,
@@ -41955,7 +41974,7 @@ var PatchStore = class {
       createdAt: Date.now(),
       status: "ready"
     };
-    writeFileSync10(record4.path, patch, { mode: 384 });
+    writeFileSync9(record4.path, patch, { mode: 384 });
     this.records.set(id, record4);
     this.persist(record4);
     return record4;
@@ -41974,7 +41993,7 @@ var PatchStore = class {
   }
   persist(record4) {
     try {
-      writeFileSync10(record4.path.replace(/\.patch$/, ".json"), JSON.stringify(record4, null, "	"), { mode: 384 });
+      writeFileSync9(record4.path.replace(/\.patch$/, ".json"), JSON.stringify(record4, null, "	"), { mode: 384 });
     } catch {
     }
   }
@@ -42059,7 +42078,7 @@ async function applyPatch(run2, options) {
     return { code: applied.code, stderr: applied.stderr, unmerged: [...new Set(paths)] };
   };
   try {
-    mkdirSync13(options.scratchDir, { recursive: true, mode: 448 });
+    mkdirSync12(options.scratchDir, { recursive: true, mode: 448 });
     const dry = await attempt(true);
     if (dry.code !== 0 && dry.unmerged.length === 0) return { status: "failed", reasons: errorLines(dry.stderr) };
     if (dry.unmerged.length > 0 && options.onConflict === "abort")
@@ -42241,7 +42260,7 @@ function swarmText(snapshot2, options) {
 var import_typebox5 = __toESM(require_typebox(), 1);
 import { rm as rm3 } from "node:fs/promises";
 import { tmpdir as tmpdir4 } from "node:os";
-import { basename as basename5, dirname as dirname7, join as join27 } from "node:path";
+import { basename as basename5, dirname as dirname6, join as join27 } from "node:path";
 
 // packages/kyrn-judge/src/decisions/swarm-patch.ts
 var MAX_JUDGED_FILES = 12;
@@ -42538,7 +42557,7 @@ ${statLines(record4.summary, 200).join("\n")}`);
           patchPath: record4.path,
           files: record4.summary.files,
           onConflict: params.conflicts ?? "abort",
-          scratchDir: join27(dirname7(record4.path), "scratch"),
+          scratchDir: join27(dirname6(record4.path), "scratch"),
           signal
         });
         const details = { id: record4.id, result };
@@ -43194,7 +43213,7 @@ function registerSwarmCommand(runtime) {
 }
 
 // packages/kyrn-judge/src/extension/features/swarm-child.ts
-import { readFileSync as readFileSync15, renameSync as renameSync5, writeFileSync as writeFileSync11 } from "node:fs";
+import { readFileSync as readFileSync15, renameSync as renameSync5, writeFileSync as writeFileSync10 } from "node:fs";
 var states = /* @__PURE__ */ new WeakMap();
 function isWrappingUp(runtime) {
   return states.get(runtime)?.wrapping === true;
@@ -43222,7 +43241,7 @@ function registerSwarmChild(runtime, path, frameOutPath2) {
     const text7 = JSON.stringify(frameOut(frame));
     if (text7 === saved) return void 0;
     try {
-      writeFileSync11(`${frameOutPath2}.tmp`, text7);
+      writeFileSync10(`${frameOutPath2}.tmp`, text7);
       renameSync5(`${frameOutPath2}.tmp`, frameOutPath2);
       saved = text7;
     } catch {
@@ -43926,7 +43945,7 @@ var import_pi_coding_agent9 = __toESM(require_pi_coding_agent(), 1);
 var import_pi_tui4 = __toESM(require_pi_tui(), 1);
 
 // packages/kyrn-judge/src/import/index.ts
-import { mkdirSync as mkdirSync14, readdirSync as readdirSync6, readFileSync as readFileSync16, realpathSync as realpathSync2, renameSync as renameSync7, statSync as statSync11, writeFileSync as writeFileSync12 } from "node:fs";
+import { mkdirSync as mkdirSync13, readdirSync as readdirSync6, readFileSync as readFileSync16, realpathSync as realpathSync2, renameSync as renameSync7, statSync as statSync11, writeFileSync as writeFileSync11 } from "node:fs";
 import { homedir as homedir7 } from "node:os";
 import { join as join32 } from "node:path";
 
@@ -45973,8 +45992,8 @@ function readChecks(store) {
 function writeChecks(store, checks) {
   const file = checksFile(store);
   try {
-    mkdirSync14(absolute(store.agentDir), { recursive: true });
-    writeFileSync12(`${file}.tmp`, `${JSON.stringify(checks, null, 1)}
+    mkdirSync13(absolute(store.agentDir), { recursive: true });
+    writeFileSync11(`${file}.tmp`, `${JSON.stringify(checks, null, 1)}
 `, { mode: 384 });
     renameSync7(`${file}.tmp`, file);
   } catch {
@@ -46146,7 +46165,7 @@ async function importOne(path, options, imports, checks) {
     }
     if (earlier) converted = await read(tool, source, readOptions());
     const dir = sessionDirFor(converted.cwd, options);
-    mkdirSync14(dir, { recursive: true });
+    mkdirSync13(dir, { recursive: true });
     const sessionFile = join32(dir, sessionFileName(converted.started, converted.sessionId));
     writeSessionFile(sessionFile, converted.entries);
     imports.push({
@@ -46355,7 +46374,7 @@ import { isAbsolute as isAbsolute4, join as join38, resolve as resolve7 } from "
 
 // packages/kyrn-judge/src/inherit/files.ts
 import { existsSync as existsSync13, readdirSync as readdirSync7, readFileSync as readFileSync17, realpathSync as realpathSync3, statSync as statSync12 } from "node:fs";
-import { dirname as dirname8, join as join33, resolve as resolve5 } from "node:path";
+import { dirname as dirname7, join as join33, resolve as resolve5 } from "node:path";
 var MAX_FILE_BYTES = 2 * 1024 * 1024;
 function projectChain(projectDir, home) {
   const start = resolve5(projectDir);
@@ -46366,7 +46385,7 @@ function projectChain(projectDir, home) {
     if (current === homeDir) break;
     chain.push(current);
     if (existsSync13(join33(current, ".git"))) return chain;
-    const parent = dirname8(current);
+    const parent = dirname7(current);
     if (parent === current) break;
     current = parent;
   }
@@ -46679,8 +46698,8 @@ function rulesForFile(rules, filePath) {
 }
 
 // packages/kyrn-judge/src/inherit/scan.ts
-import { mkdirSync as mkdirSync15, readFileSync as readFileSync18, writeFileSync as writeFileSync13 } from "node:fs";
-import { dirname as dirname9, join as join37 } from "node:path";
+import { mkdirSync as mkdirSync14, readFileSync as readFileSync18, writeFileSync as writeFileSync12 } from "node:fs";
+import { dirname as dirname8, join as join37 } from "node:path";
 
 // packages/kyrn-judge/src/inherit/mcp-config.ts
 import { join as join35, resolve as resolve6 } from "node:path";
@@ -47368,8 +47387,8 @@ function readInheritState(agentDir) {
 }
 function writeInheritState(agentDir, state) {
   const path = inheritStatePath(agentDir);
-  mkdirSync15(dirname9(path), { recursive: true });
-  writeFileSync13(path, `${JSON.stringify(state, null, "	")}
+  mkdirSync14(dirname8(path), { recursive: true });
+  writeFileSync12(path, `${JSON.stringify(state, null, "	")}
 `);
 }
 
@@ -47622,8 +47641,8 @@ function looksPoisoned(text7) {
 // packages/kyrn-judge/src/extension/features/tool-descriptions.ts
 var import_pi_coding_agent11 = __toESM(require_pi_coding_agent(), 1);
 import { createHash as createHash6 } from "node:crypto";
-import { mkdirSync as mkdirSync16, readFileSync as readFileSync19, renameSync as renameSync8, writeFileSync as writeFileSync14 } from "node:fs";
-import { dirname as dirname10, join as join39 } from "node:path";
+import { mkdirSync as mkdirSync15, readFileSync as readFileSync19, renameSync as renameSync8, writeFileSync as writeFileSync13 } from "node:fs";
+import { dirname as dirname9, join as join39 } from "node:path";
 var STORE_LIMIT = 2e3;
 var VerdictStore = class {
   file;
@@ -47658,9 +47677,9 @@ var VerdictStore = class {
     const newest = [...all].sort(([, a], [, b]) => b.at - a.at).slice(0, STORE_LIMIT);
     const flat4 = Object.fromEntries(newest.map(([key, entry]) => [key, { ...entry.verdict, at: entry.at }]));
     try {
-      mkdirSync16(dirname10(this.file), { recursive: true });
+      mkdirSync15(dirname9(this.file), { recursive: true });
       const temp = `${this.file}.${process.pid}.tmp`;
-      writeFileSync14(temp, `${JSON.stringify({ version: 1, verdicts: flat4 })}
+      writeFileSync13(temp, `${JSON.stringify({ version: 1, verdicts: flat4 })}
 `, { mode: 384 });
       renameSync8(temp, this.file);
     } catch {
@@ -49214,15 +49233,19 @@ function registerJudgeItems(runtime) {
 }
 
 // packages/kyrn-judge/src/extension/features/laya.ts
+var PENDING_KEY = "layaRemoved";
+function layaNoticeOf(skipped, first) {
+  return { judge: skipped.replacement ?? first, from: skipped.env && !skipped.file ? "MU_JUDGE" : "mu.json" };
+}
 function judgeName(name) {
   return name === "mude" ? "mude 1.0" : judgeDisplayName(name);
 }
-function layaNotice(skipped, judge) {
-  const name = judgeName(skipped.replacement ?? judge);
-  if (skipped.env && !skipped.file) {
+function layaNotice(notice) {
+  const name = judgeName(notice.judge);
+  if (notice.from === "MU_JUDGE") {
     return say({
       zh: `mu\uFF1A\u4E0D\u518D\u5185\u7F6E Laya\uFF0C\u6240\u4EE5\u8DF3\u8FC7\u4E86 MU_JUDGE \u91CC\u7684 laya\uFF0C\u5224\u5B9A\u5668\u73B0\u5728\u662F ${name}\u3002\u60F3\u7528\u522B\u7684\u51B3\u7B56\u6A21\u578B\uFF0C\u53EF\u4EE5\u4ECE Hugging Face \u6DFB\u52A0\uFF1Amu judge model add <\u94FE\u63A5>\uFF08\u6216\u5728\u684C\u9762\u7AEF\u300C\u8BBE\u7F6E \u2192 \u5224\u5B9A\u5668\u300D\u91CC\u6DFB\u52A0\uFF09\u3002`,
-      en: `mu: Laya is no longer built in, so mu skips the laya in MU_JUDGE and your judge is now ${name}. To use another decision model, add it from Hugging Face: mu judge model add <link> (or Settings \u2192 Judges in the desktop app).`
+      en: `mu: Laya is no longer built in, so mu skips laya in MU_JUDGE and your judge is now ${name}. To use another decision model, add it from Hugging Face: mu judge model add <link> (or Settings \u2192 Judges in the desktop app).`
     });
   }
   return say({
@@ -49230,21 +49253,60 @@ function layaNotice(skipped, judge) {
     en: `mu: Laya is no longer built in, so your judge is now ${name}. To use another decision model, add it from Hugging Face: mu judge model add <link> (or Settings \u2192 Judges in the desktop app).`
   });
 }
+function pendingLayaNotice(file) {
+  const value = readNotices(file)[PENDING_KEY];
+  if (typeof value !== "object" || value === null) return void 0;
+  const { judge, from } = value;
+  if (typeof judge !== "string" || !judge.trim()) return void 0;
+  return { judge, from: from === "MU_JUDGE" ? "MU_JUDGE" : "mu.json" };
+}
+function holdNotice(file, notice) {
+  try {
+    if (notice.from === "MU_JUDGE" && pendingLayaNotice(file)?.from === "mu.json") return true;
+    writeNotice(file, PENDING_KEY, notice);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function registerLayaNotice(runtime, skipped, roots, muHome2) {
-  let done = false;
-  runtime.pi.on("session_start", (_event, ctx) => {
+  const file = roots ? noticesFile(roots.agentDir) : void 0;
+  if (!skipped && !file) return;
+  let held;
+  let started = false;
+  let asked = false;
+  if (skipped) {
+    runtime.pi.on("session_start", (_event, ctx) => {
+      try {
+        if (started || !ctx.hasUI) return;
+        started = true;
+        if (skipped.file && roots) {
+          migrateConfigFile({ agentDir: roots.agentDir, muHome: muHome2, replacement: skipped.replacement });
+        }
+        const notice = layaNoticeOf(skipped, runtime.config.tiers[0] ?? "jev");
+        if (!file || !holdNotice(file, notice)) held = notice;
+      } catch {
+      }
+    });
+  }
+  runtime.pi.on("input", (event, ctx) => {
     try {
-      if (done || !ctx.hasUI) return;
-      done = true;
-      if (skipped.file && roots) {
-        migrateConfigFile({ agentDir: roots.agentDir, muHome: muHome2, replacement: skipped.replacement });
-      }
-      const message = layaNotice(skipped, runtime.config.tiers[0] ?? "jev");
-      runtime.present("judge.notice", {
-        code: "laya_removed",
-        judge: skipped.replacement ?? runtime.config.tiers[0] ?? "jev",
-        message
-      });
+      if (asked || !ctx.hasUI || event.source === "extension") return;
+      if (!event.text.trim() && !event.images?.length) return;
+      asked = true;
+      const waiting = pendingLayaNotice(file);
+      const notice = waiting ?? held;
+      if (!notice) return;
+      held = void 0;
+      if (waiting && file) {
+        try {
+          writeNotice(file, PENDING_KEY, void 0);
+        } catch {
+        }
+      }
+      const message = layaNotice(notice);
+      runtime.touch(ctx);
+      runtime.present("judge.notice", { code: "laya_removed", judge: notice.judge, message });
       ctx.ui.notify(message, "info");
     } catch {
     }
@@ -50967,7 +51029,7 @@ function capabilityId(serverName) {
 
 // packages/kyrn-judge/src/mcp/store.ts
 import { createHash as createHash7 } from "node:crypto";
-import { mkdirSync as mkdirSync17, readFileSync as readFileSync21, renameSync as renameSync9, writeFileSync as writeFileSync15 } from "node:fs";
+import { mkdirSync as mkdirSync16, readFileSync as readFileSync21, renameSync as renameSync9, writeFileSync as writeFileSync14 } from "node:fs";
 import { join as join41, resolve as resolve9 } from "node:path";
 var DESCRIPTION_LENGTH2 = 200;
 function sorted(map) {
@@ -50999,9 +51061,9 @@ function readJson(path, empty) {
 function writeJson(path, value) {
   if (!path) return;
   try {
-    mkdirSync17(resolve9(path, ".."), { recursive: true });
+    mkdirSync16(resolve9(path, ".."), { recursive: true });
     const temporary = `${path}.${process.pid}.tmp`;
-    writeFileSync15(temporary, `${JSON.stringify(value, null, "	")}
+    writeFileSync14(temporary, `${JSON.stringify(value, null, "	")}
 `);
     renameSync9(temporary, path);
   } catch {
@@ -51664,8 +51726,8 @@ function turnDigest(turn) {
 }
 
 // packages/kyrn-judge/src/memory/store.ts
-import { appendFileSync as appendFileSync4, closeSync as closeSync5, fstatSync as fstatSync3, mkdirSync as mkdirSync18, openSync as openSync5, readFileSync as readFileSync22, readSync as readSync4 } from "node:fs";
-import { dirname as dirname11 } from "node:path";
+import { appendFileSync as appendFileSync4, closeSync as closeSync5, fstatSync as fstatSync3, mkdirSync as mkdirSync17, openSync as openSync5, readFileSync as readFileSync22, readSync as readSync4 } from "node:fs";
+import { dirname as dirname10 } from "node:path";
 var KINDS4 = ["correction", "preference", "pitfall", "workaround", "fact"];
 var ORIGINS = ["user", "outcome", "model", "subagent", "command"];
 var STATUSES = ["active", "retired", "superseded"];
@@ -51769,7 +51831,7 @@ function endsOpen(path) {
   }
 }
 function writeLesson(path, line2) {
-  mkdirSync18(dirname11(path), { recursive: true });
+  mkdirSync17(dirname10(path), { recursive: true });
   appendFileSync4(path, `${endsOpen(path) ? "\n" : ""}${JSON.stringify(line2)}
 `);
 }
@@ -54155,7 +54217,7 @@ function report2(outcome) {
 var import_typebox12 = __toESM(require_typebox(), 1);
 import { realpathSync as realpathSync4 } from "node:fs";
 import { readFile as readFile5, writeFile as writeFile6 } from "node:fs/promises";
-import { basename as basename13, dirname as dirname12, isAbsolute as isAbsolute5, join as join46, relative as relative5 } from "node:path";
+import { basename as basename13, dirname as dirname11, isAbsolute as isAbsolute5, join as join46, relative as relative5 } from "node:path";
 
 // packages/kyrn-judge/src/packs/conflicts.ts
 import { mkdtemp as mkdtemp2, rm as rm5, writeFile as writeFile5 } from "node:fs/promises";
@@ -54292,7 +54354,7 @@ function real(path) {
   try {
     return realpathSync4.native(path);
   } catch {
-    const parent = dirname12(path);
+    const parent = dirname11(path);
     return parent === path ? path : join46(real(parent), basename13(path));
   }
 }
@@ -55738,9 +55800,9 @@ var toolApproval = defineDecision({
 });
 
 // packages/kyrn-judge/src/permissions/modes.ts
-import { lstatSync as lstatSync2, mkdirSync as mkdirSync19, readFileSync as readFileSync23, readlinkSync, realpathSync as realpathSync5, renameSync as renameSync10, writeFileSync as writeFileSync16 } from "node:fs";
+import { lstatSync as lstatSync2, mkdirSync as mkdirSync18, readFileSync as readFileSync23, readlinkSync, realpathSync as realpathSync5, renameSync as renameSync10, writeFileSync as writeFileSync15 } from "node:fs";
 import { homedir as homedir10 } from "node:os";
-import { basename as basename14, dirname as dirname13, isAbsolute as isAbsolute7, join as join47, relative as relative7, resolve as resolve12, sep as sep2 } from "node:path";
+import { basename as basename14, dirname as dirname12, isAbsolute as isAbsolute7, join as join47, relative as relative7, resolve as resolve12, sep as sep2 } from "node:path";
 import { fileURLToPath as fileURLToPath5 } from "node:url";
 var PERMISSION_MODES = ["full", "judge", "ask"];
 var MODE_TEXT = {
@@ -55828,11 +55890,11 @@ function realPath2(path, depth = 0) {
     if (depth < 40) {
       try {
         if (lstatSync2(path).isSymbolicLink())
-          return realPath2(resolve12(dirname13(path), readlinkSync(path)), depth + 1);
+          return realPath2(resolve12(dirname12(path), readlinkSync(path)), depth + 1);
       } catch {
       }
     }
-    const parent = dirname13(path);
+    const parent = dirname12(path);
     return parent === path ? path : join47(realPath2(parent, depth + 1), basename14(path));
   }
 }
@@ -55973,9 +56035,9 @@ var PermissionDefaults = class {
       this.memory = mode;
       return;
     }
-    mkdirSync19(join47(this.file, ".."), { recursive: true });
+    mkdirSync18(join47(this.file, ".."), { recursive: true });
     const temp = `${this.file}.${process.pid}.tmp`;
-    writeFileSync16(temp, `${JSON.stringify({ version: 1, mode }, null, "	")}
+    writeFileSync15(temp, `${JSON.stringify({ version: 1, mode }, null, "	")}
 `, { mode: 384 });
     renameSync10(temp, this.file);
   }
@@ -56970,7 +57032,7 @@ var skillCapture = defineDecision({
 });
 
 // packages/kyrn-judge/src/memory/skill-drafts.ts
-import { existsSync as existsSync16, mkdirSync as mkdirSync20, readdirSync as readdirSync9, readFileSync as readFileSync24, rmSync as rmSync8, writeFileSync as writeFileSync17 } from "node:fs";
+import { existsSync as existsSync16, mkdirSync as mkdirSync19, readdirSync as readdirSync9, readFileSync as readFileSync24, rmSync as rmSync8, writeFileSync as writeFileSync16 } from "node:fs";
 import { join as join49 } from "node:path";
 var MAX_NAME = 64;
 var MAX_DESCRIPTION = 300;
@@ -57035,9 +57097,9 @@ var SkillDrafts = class {
       created: (/* @__PURE__ */ new Date()).toISOString()
     };
     const folder = join49(this.dir, name);
-    mkdirSync20(folder, { recursive: true });
-    writeFileSync17(join49(folder, "SKILL.md"), markdown);
-    writeFileSync17(join49(folder, "draft.json"), `${JSON.stringify(meta, null, "	")}
+    mkdirSync19(folder, { recursive: true });
+    writeFileSync16(join49(folder, "SKILL.md"), markdown);
+    writeFileSync16(join49(folder, "draft.json"), `${JSON.stringify(meta, null, "	")}
 `);
     return { ...meta, markdown };
   }
@@ -57057,8 +57119,8 @@ var SkillDrafts = class {
     const folder = join49(skillsDir, draft.name);
     const path = join49(folder, "SKILL.md");
     if (existsSync16(path)) return { error: "exists" };
-    mkdirSync20(folder, { recursive: true });
-    writeFileSync17(path, draft.markdown);
+    mkdirSync19(folder, { recursive: true });
+    writeFileSync16(path, draft.markdown);
     this.remove(draft.name);
     return { path };
   }
@@ -58031,7 +58093,7 @@ function registerWatchdog(runtime) {
 import { join as join51 } from "node:path";
 
 // packages/kyrn-judge/src/auth/exit.ts
-import { mkdirSync as mkdirSync21, rmdirSync as rmdirSync2 } from "node:fs";
+import { mkdirSync as mkdirSync20, rmdirSync as rmdirSync2 } from "node:fs";
 import { resolve as resolve14 } from "node:path";
 import { setTimeout as sleep3 } from "node:timers/promises";
 async function holdLocksUntilExit(files, {
@@ -58065,7 +58127,7 @@ function takeAll(locks) {
   const taken = [];
   for (const lock of locks) {
     try {
-      mkdirSync21(lock);
+      mkdirSync20(lock);
       taken.push(lock);
     } catch (error) {
       if (error.code !== "EEXIST") continue;
@@ -58144,7 +58206,7 @@ function registerKyrn(pi, options) {
   registerWelcome(runtime);
   const roots = options.roots ?? (options.config || options.provider ? void 0 : { home: homedir12(), agentDir: (0, import_pi_coding_agent17.getAgentDir)() });
   runtime.stateDir = roots ? join52(roots.agentDir, "mu") : void 0;
-  if (loaded.laya) registerLayaNotice(runtime, loaded.laya, roots, home);
+  registerLayaNotice(runtime, loaded.laya, roots, home);
   if (loaded.disabled) {
     if (!options.only || options.only.includes("permissions")) registerPermissions(runtime, roots);
     registerCommands(runtime, roots);

package/kyrn/bin/kyrn-doctor

@@ -345,10 +345,13 @@ const { browserAdvice, findBrowser, thisBrowserHost } = await import(
 const browserHost = thisBrowserHost();
 const chrome = findBrowser(browserHost);
 const [advice, ...moreAdvice] = chrome ? [] : browserAdvice(browserHost).split("\n");
+// Only mu's browser needs one: without it the rest of mu works, so it is not something to fix.
 row(
-	chrome ? "ok" : "fix",
+	chrome ? "ok" : "--",
 	"browser",
-	chrome ? `${chrome.executable}${chrome.side === "windows" ? "  (on the Windows side, reached over mirrored networking)" : ""}` : advice,
+	chrome
+		? `${chrome.executable}${chrome.side === "windows" ? "  (on the Windows side, reached over mirrored networking)" : ""}`
+		: `optional, for mu's browser. ${advice}`,
 );
 for (const line of moreAdvice) row("--", "", line);
 const canRelate = (tier) =>

package/kyrn/bin/mu.mjs

@@ -101,12 +101,16 @@ export function usage(platform) {
 		'  mu "prompt"              start a session with this prompt',
 		'  mu -p "prompt"           run one prompt, print the answer and exit',
 		"  mu -c | -r               continue the last session | pick a session to resume",
-		"  mu setup                 connect a model (paste an API key or pick a service) and choose a judge (mu setup --help)",
-		"  mu judge mude install    install mude 1.0, mu's own decision model for coding, and make it the judge on this Mac (Apple silicon, 1.8 GB)",
+		"  mu setup                 connect a model (paste an API key or pick a service) and choose",
+		"                           a judge (mu setup --help)",
+		"  mu judge mude install    install mude 1.0, mu's own decision model for coding, and make it",
+		"                           the judge on this Mac (Apple silicon, 1.8 GB)",
 		"                           enable | disable | start | stop | status | uninstall (mu judge mude help)",
-		"  mu judge model <cmd>     other decision models from Hugging Face: add <link> | list | use | remove (mu judge model help)",
+		"  mu judge model <cmd>     other decision models from Hugging Face:",
+		"                           add <link> | list | use | remove (mu judge model help)",
 		"  mu ledger [n] [--json]   print the judge's verdicts from the last n sessions",
-		"  mu import <file>...      import Claude Code, Codex and ZCode conversations; --list shows them (mu import --help)",
+		"  mu import <file>...      import Claude Code, Codex and ZCode conversations; --list shows",
+		"                           them (mu import --help)",
 		"  mu doctor                check the installation, the judges and the connections",
 		"  mu auth <cmd>            sign-in helper for the desktop app (JSON lines):",
 		"                           status | login <provider> | logout <provider>",
@@ -771,8 +775,8 @@ export const AUTH_USAGE = [
 	"  mu auth status",
 	"  mu auth login <provider> [--paste]",
 	"  mu auth logout <provider>",
-	"In a terminal, /login inside mu signs in the same way. With --paste, the sign-in takes the address the browser",
-	"ends on as pasted instead of listening for it: for when another program (the Codex CLI) holds the callback port.",
+	"In a terminal, /login inside mu signs in the same way. With --paste, you paste the address the browser ends on",
+	"instead of mu listening for it. Use it when another program, such as the Codex CLI, holds the callback port.",
 	"",
 	"pi's auth commands:",
 ].join("\n");
@@ -836,7 +840,7 @@ export function planJudge({ argv }) {
 			kind: "removed",
 			code: 1,
 			text: [
-				`mu judge ${command} managed Laya, which is no longer built into mu.`,
+				`mu judge ${command} used to manage Laya, which is no longer built into mu.`,
 				"For a decision model on this machine, install mude 1.0 (mu judge mude install), or add one from Hugging Face (mu judge model add <link>).",
 			].join("\n"),
 		};

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mu-agent",
-	"version": "0.2.5",
+	"version": "0.2.6",
 	"description": "mu: a coding agent that hands its routine decisions to a small, fast judge model, so the main model can keep its attention on the work. Built on pi.",
 	"type": "module",
 	"bin": {
@@ -42,6 +42,6 @@
 	"muBuild": {
 		"pi": "1.3.0",
 		"judge": "0.1.0",
-		"commit": "b7733c26e"
+		"commit": "bd42ca6ba"
 	}
 }