mirror-mind 0.40.0 → 0.41.0

package/docs/releases/index.md

@@ -12,6 +12,8 @@ Future release notes should use the structure defined in [Release Notes](../proc
 
 ## Releases
 
+- [v0.41.0 — A Persona When the Subject Asks for One](v0.41.0.md) — minor release of CR203 and CR204: a Mirror Mode turn's persona is routed by its subject, by a Decisions model through OpenRouter taken only above a threshold, else the Journey's `default_persona`, else none; a turn never inherits the session's persona, and a turn with none tells the model not to sign; every routing failure is none; one content-free `llm_calls` row per call; `mirror-mind/desktop` returns `personaName` beside the persona's id. No migration.
+- [v0.40.1 — The Bins You Named, or Why Not](v0.40.1.md) — patch release of CR197: the plugin's hook wrappers and MCP entry use `MIRROR_BIN` only as an absolute path to a directory holding the bin they need, the rule `MIRROR_NODE` follows since v0.39.5; a relative value is never used, so a project's own `bin/mirror-hook` cannot run, and a refused value is named with its reason, once a day in `hooks.log` and on the MCP entry's stderr; the forward-slash `C:/…` form Windows machines set counts as absolute, in CI under Git Bash. Also carries CV9's re-baseline (documents only). No migration.
 - [v0.40.0 — A Reply Stays in Its Own Conversation, and a Journey Can Go](v0.40.0.md) — minor release closing the first release train: CR151, a session's transcript fills only the conversation that session is bound to, each reply stamped with its transcript time, where it used to fill every open reply-less conversation in the transcript's window, another session's included; a transcript no session owns backfills nothing; and CR200, previewed as v0.40.0-next.1, `mirror-mind/desktop` deletes a Journey with every record that belongs to it, by digest, behind a verified backup. Update every install that has a home. No migration.
 - [v0.40.0-next.1 — A Journey Can Go, Showing What Goes With It](v0.40.0-next.1.md) — preview under npm's `next`, read by no updater, for Nautilus for Mirror (the release train): CR200, `mirror-mind/desktop` gains `previewJourneyDeletion` and `deleteJourneyWithRecords`, deleting a Journey with every record that belongs to it after a preview that counts it, by digest, behind a verified backup; child Journeys refuse. Terminal users receive it with v0.40.0. No migration.
 - [v0.39.5 — The Node You Named, or Why Not](v0.39.5.md) — patch release of CR192, from PR #47's thread (@rodrigoimmaginario): the hook wrappers, the plugin's MCP entry, and `runtime diagnose` use `MIRROR_NODE` only as an absolute path to an executable file, as the Pi extension does; a relative value is never run, and a refused one is named with its reason, once a day in `hooks.log` and on the MCP entry's stderr; the Windows installer's drive-letter path counts as absolute, in CI under Git Bash and on the installer. No migration.

package/docs/releases/v0.40.1.md

@@ -0,0 +1,120 @@
+---
+digest: >
+  v0.40.1 is a patch release of one Change Request, CR197. The plugin's hook wrappers and
+  MCP entry now use `MIRROR_BIN` only when it is an absolute path to a directory holding the
+  bin they need, the rule `MIRROR_NODE` follows since v0.39.5. A relative value could make
+  a plugin hook run a JavaScript file from the project the runtime was opened in, and a
+  value that no longer held `mirror-hook` was dropped without a word. Now neither is used,
+  and the refused value is named with its reason. The forward-slash drive form Windows
+  machines set for the Claude Code forwarders counts as absolute, proven in CI under Git
+  Bash. No schema change, no migration, and no model or prompt change.
+---
+
+# v0.40.1 — The Bins You Named, or Why Not
+
+**Date:** 2026-11-07
+
+## Highlights
+
+- **A relative `MIRROR_BIN` is never used**
+  ([CR197](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr197-the-hook-wrappers-and-the-mcp-locator-accept-a-relative-mirror-bin.md)).
+  `MIRROR_BIN` names the directory holding `mirror` and `mirror-hook`, for the plugin's
+  hook wrappers and MCP entry, which a runtime copies into its own cache. A runtime starts
+  them from the project it was opened in, and both readers took any value that passed
+  `[ -x ]` there: with `MIRROR_BIN=bin`, Node ran the project's `bin/mirror-hook` as
+  JavaScript on every plugin hook, and its `bin/mirror` at every MCP server start. Both
+  readers now use the value only as an absolute path to a directory holding the bin they
+  need as an executable file.
+- **A value that is not used is named, with its reason.** A value that no longer held the
+  bin, such as a prefix left behind by a Node switch, used to be dropped without a word.
+  Now the hook wrappers write
+  `MIRROR_BIN=bin is relative; searching the PATH and the usual places instead` to
+  `<mirror home>/hooks.log`, once a UTC day for the same value, and the MCP entry writes
+  the same message to its stderr. The reasons are `relative`, `missing`,
+  `not a directory`, and `a directory without an executable mirror-hook` (or `mirror`).
+  The search then goes on through the PATH and the usual places, as before.
+- **The Windows form counts as absolute.** The rule uses `MIRROR_NODE`'s pattern, so
+  `C:/Users/<you>/.mirror/bin`, the forward-slash form Windows machines set for the Claude
+  Code forwarders, is absolute, and a drive-relative `C:bin` is refused as `relative`. The
+  Windows CI job runs a plugin wrapper with that form under Git Bash.
+- No schema change, no migration, and no model or prompt change.
+
+## Where We Started
+
+v0.39.5 gave `MIRROR_NODE` its rule
+([CR192](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr192-the-hook-wrappers-and-the-mcp-locator-accept-a-relative-mirror-node.md)),
+and its review found the same exposure one variable over: with `MIRROR_BIN=bin`, the
+plugin's prompt hook made Node run the project's `bin/mirror-hook`, probed on 2026-11-04.
+It was captured as CR197 and left out of v0.39.5 on purpose. On 2026-11-07 the CV9
+re-baseline decided to ship it as a patch ahead of the 1.0 gate.
+
+## What Changed
+
+**One rule, two variables.** The plugin's bin and agy wrappers, generated by
+`scripts/generate_hook_wrappers.sh`, and the MCP locator in
+`ts/src/guards/claudePlugin.ts` test `MIRROR_BIN` with `ABSOLUTE_PATH_CASE`, the pattern
+`MIRROR_NODE` uses, and a test fails if the copies drift. The bin search now carries the
+pattern's backslashes, so the generator splices it by the text around its placeholder, as
+it does the other shared fragments. The eight plugin wrappers are regenerated; the five
+tree-form wrappers under `.claude/hooks/` read no `MIRROR_BIN` and are unchanged.
+
+**A refusal that cannot forge a line.** Line breaks are removed from the value before it is
+logged, as for `MIRROR_NODE`. The locator reads `$MIRROR_BIN` once, where it read it three
+times, because Grok pastes a set variable's value into the MCP arguments it loads.
+
+**Tests and CI.** The new tests ran the project's planted `bin/mirror-hook` and
+`bin/mirror` before the fix. They cover each reason, the daily rule, a forged line break,
+both variables refused in one run, the agy form, and a valid value that outranks the PATH.
+The Windows job's Git Bash step runs a plugin wrapper over a prefix shaped like npm's on
+Windows, with `MIRROR_BIN` in the forward-slash drive form.
+
+**Docs.** The rule is stated once, in full, in the
+[configuration reference](../reference/configuration.md#hook-bin-resolution), and
+`REFERENCE.md` points there. Troubleshooting shows the refusal line and the fix, and no
+longer says `MIRROR_BIN` is honored as given. Getting Started says the directory is given
+as an absolute path.
+
+Validated by the Navigator in a scratch home: two runs of the plugin's prompt hook with
+`MIRROR_BIN=bin` wrote one line,
+
+```text
+2026-11-07T19:11:56Z claude:user-prompt: MIRROR_BIN=bin is relative; searching the PATH and the usual places instead
+```
+
+the MCP entry printed the same refusal and answered `initialize`, the project's planted
+bins never ran, the prompt was logged, and `/opt/homebrew/bin`, the value his own Claude
+settings set, was used with no refusal.
+
+**Also in this release.** CV9's re-baseline
+([CV9.DS10](../project/roadmap/cv9-mirror-1-0/cv9-ds10-the-1-0-done-condition-describes-the-system-that-exists/index.md)),
+which changes documents only: the 1.0 done condition is now a table of claims, each with
+the story that owns it.
+
+## Conscious Exclusions
+
+- `runtime diagnose` does not name a refused `MIRROR_BIN`. It counts the hooks' line as
+  `hook_failures_recorded`, and the value and its reason are in `hooks.log`. Deferred to
+  [CR198](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr198-runtime-diagnose-does-not-name-a-refused-mirror-node.md),
+  which now covers both variables.
+- A relative entry in your own `PATH`, such as `.`: `command -v` finds a project's file
+  through it for every command you run, not only Mirror's.
+- An absolute value is trusted wherever it points: whoever sets it chooses what runs.
+- Rodrigo Immaginario's installer run against `main` was asked for and does not gate this
+  tag; the Windows CI job is this release's Windows evidence.
+
+## Upgrading
+
+```bash
+mirror runtime update
+```
+
+If you set `MIRROR_BIN` by hand, make it the absolute path of the directory holding
+`mirror-hook`, `$(npm prefix -g)/bin`: a relative one is now refused, with one line a day
+in `hooks.log`. A plugin copied into a runtime's cache keeps the old wrappers until the
+runtime takes the update; `runtime diagnose` reports a copy that is behind.
+
+## Next Horizon
+
+CR198, so that `runtime diagnose` names a refused `MIRROR_NODE` or `MIRROR_BIN`; CV9.DS11,
+journeys that can be reshaped without losing a record; and the rest of the way to 1.0 in
+the [CV9 index](../project/roadmap/cv9-mirror-1-0/index.md).

package/docs/releases/v0.41.0.md

@@ -0,0 +1,116 @@
+---
+digest: >
+  v0.41.0 routes each Mirror Mode turn's persona by what the turn is about, and lets a turn
+  have none. A Decisions model chooses among your personas and says whether the subject
+  belongs to any of them; its choice is taken only above a threshold, else the persona the
+  turn's Journey names as its default, else none. A turn no longer inherits the session's
+  persona, and a turn with none tells the model not to sign. `mirror-mind/desktop` also hands
+  its host the persona's own name beside its id. One new model call per turn, made beside
+  the embedding the turn already makes. No schema change, no migration.
+---
+
+# v0.41.0 — A Persona When the Subject Asks for One
+
+**Date:** 2026-11-08
+
+## Highlights
+
+- **A turn's persona follows its subject, or there is none**
+  ([CR203](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr203-route-a-turns-persona-by-its-subject-and-let-it-have-none.md)).
+  In Mirror Mode, on the delta of an ordinary turn and on the full load alike, the persona
+  is, in order: the one you named (`mirror load --persona`); the router's answer, a
+  Decisions model through OpenRouter's Decisions API asked which persona the subject
+  belongs to and whether it belongs to any, taken only at or above a threshold; the persona
+  the turn's Journey names as `default_persona` in its metadata; or none. It is never the
+  session's by inheritance.
+- **None is said, not left silent.** A turn with no persona delivers
+  `persona: none` and the clause
+  `answer as the mirror; no persona this turn: do not sign, and do not answer as an earlier persona`,
+  so the model does not keep signing as the last persona it answered as.
+- **Every routing failure is none, and the turn goes on.** No key, a timeout, a refusal, a
+  malformed answer or a persona that does not exist each give a turn with no persona. One
+  attempt, bounded like reception (`MEMORY_LLM_TIMEOUT_RECEPTION`, 10 s by default).
+- **Two settings.** `MEMORY_PERSONA_ROUTER_MODEL` (`liquid/d1-ultra`) and
+  `MEMORY_PERSONA_ROUTER_THRESHOLD` (`0.6`), in [`REFERENCE.md`](../../REFERENCE.md); an
+  invalid value reads as unset.
+- **The host gets the persona's name**
+  ([CR204](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr204-hand-the-host-the-personas-name-with-its-id.md)).
+  `deliverMirrorContext` in `mirror-mind/desktop` returns `personaName`, the persona's own
+  `name` from its metadata, or `null`; `persona` stays the id. Additive.
+- No schema change, no migration.
+
+## Where We Started
+
+A keyword count chose every turn's persona, and when no keyword scored, the session's
+persona kept answering. Measured on the maintainer's own data over five days (550
+deliveries), every turn had a persona, the persona changed on one turn in three, and
+specialists from unrelated domains answered: health, customer support and QA personas on a
+book-writing Journey. The maintainer's criterion: a wrong persona is worse than none,
+because it puts a false specialist into the answer, while no persona only loses one
+domain's lens and keeps identity, voice and memories.
+
+## What Changed
+
+**One router for both paths.** `ts/src/mirror/personaRouter.ts` owns the Decisions route,
+which OpenRouter marks `alpha`: its request and answer shapes live in that module and a
+contract test pins them, so a change in the route fails a test, not a turn. The doorman's
+delta and the full load call the same rule, so the two cannot disagree. The delta asks the
+router and embeds the prompt at the same time, so the call adds no wait of its own to the
+delivery. Each persona is offered with its own `description`, else its generated
+descriptor, else the start of its content.
+
+**The session records the turn's answer.** A session's persona is now the last turn's,
+none included. Which persona sections the conversation already holds is kept apart
+(`doorman_personas` in the session's metadata), so a section is delivered the first time
+its persona answers and not again; a full load starts that list over, and a compaction
+clears it.
+
+**Reception still runs** on a full load, for the Journey and the turn's shaping. It no
+longer chooses the persona. Its prompt is unchanged.
+
+**The ledger.** Each routing call writes one `llm_calls` row, `role = persona_routing`,
+with the model, latency and cost, and an empty prompt and response in every logging mode:
+the subject of your turn is not the ledger's to keep.
+
+**Measured before the release.** The router was chosen by an eval of 100 labelled turns
+from the maintainer's production data
+([report](../project/refinement/rs010-cv22-oracle-and-port-hygiene/cr203-persona-routing-eval-2026-11-07.md)).
+The same 100, rerun through this release's code on a copy of a home with 28 personas: 93
+right, 3 wrong, 4 missed (the keyword router: 35 wrong), at 0.61 s median and 1.32 s at
+p95, about US$ 0.00008 per turn. The private turns stay out of this repository; a
+synthetic set runs in CI.
+
+**Model-behavior gate.** This release changes no extraction model, embedding model or
+`prompts.ts` prompt, so the gate's letter does not apply; it does add a model call and a
+line the model reads, and the rerun above is its evidence in place of `eval --all`, which
+does not probe routing.
+
+## Conscious Exclusions
+
+- **No command sets a Journey's `default_persona` yet.** The Core reads it; setting it is a
+  follow-up. Two of the rerun's three wrong picks are a Journey's own writing persona on
+  turns that asked for none, the case a default resolves.
+- **The no-persona clause is a first wording**, one constant (`NO_PERSONA_CLAUSE`), to be
+  settled in prompt review.
+- **`detect-persona` stays** as a command, an MCP tool and a package export. It no longer
+  decides a turn.
+- **Reception's prompt still lists the personas**: its bytes are digest-pinned, and
+  changing it is its own decision.
+- **A full load's worst case grows**: reception, then routing, each bounded at 10 s. A
+  delta's is unchanged.
+- **Two personas covering one domain** remain content for their owner to merge.
+
+## Upgrading
+
+```bash
+mirror runtime update
+```
+
+Nothing to configure: the router uses the OpenRouter key Mirror already reads. The routing
+calls are the `persona_routing` rows of `mirror inspect llm-calls`. Turns without a persona
+are expected: they answer as the mirror, unsigned.
+
+## Next Horizon
+
+A command and a host call to set a Journey's `default_persona`; prompt review of the
+no-persona clause; Nautilus for Mirror showing the persona's name from `personaName`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mirror-mind",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Mirror Mind: a local-first memory and identity framework for agentic AI runtimes (Pi, Claude Code, Codex, Antigravity)",
   "license": "MIT",
   "repository": {

package/plugins/mirror-mind/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "mirror-mind",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "description": "Mirror Mind — local-first memory and identity for agentic runtimes.",
   "author": {
     "name": "Mirror Mind"
@@ -10,7 +10,7 @@
       "command": "/bin/sh",
       "args": [
         "-c",
-        "mmbin=\"\"; [ -n \"$MIRROR_BIN\" ] && [ -x \"$MIRROR_BIN/mirror\" ] && mmbin=\"$MIRROR_BIN/mirror\"; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
+        "mmbin=\"\"; mmbindir=\"$MIRROR_BIN\"; mmwhy=\"\"; [ -n \"$mmbindir\" ] && case \"$mmbindir\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ ! -e \"$mmbindir\" ]; then mmwhy=\"missing\"; elif [ ! -d \"$mmbindir\" ]; then mmwhy=\"not a directory\"; elif [ ! -f \"$mmbindir/mirror\" ] || [ ! -x \"$mmbindir/mirror\" ]; then mmwhy=\"a directory without an executable mirror\"; else mmbin=\"$mmbindir/mirror\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && printf 'mirror-mind: MIRROR_BIN=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmbindir\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
       ]
     }
   }

package/plugins/mirror-mind/agy/pre-invocation.sh

@@ -62,10 +62,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/agy/session-start.sh

@@ -62,10 +62,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/agy/stop.sh

@@ -62,10 +62,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/hooks/log-assistant-reply.sh

@@ -57,10 +57,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/hooks/log-session-end.sh

@@ -57,10 +57,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/hooks/log-user-prompt.sh

@@ -57,10 +57,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/hooks/mirror-inject.sh

@@ -57,10 +57,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/hooks/session-start.sh

@@ -57,10 +57,31 @@ note() {
 }
 
 # Find the bin. MIRROR_BIN names the directory holding `mirror` and
-# `mirror-hook` (`$(npm prefix -g)/bin`), the same trust class as MIRROR_NODE;
-# then the PATH; then the global bin directories a GUI launch leaves off it.
+# `mirror-hook` (`$(npm prefix -g)/bin`); then the PATH; then the global bin
+# directories a GUI launch leaves off it.
+#
+# MIRROR_BIN is used only as an absolute path to a directory holding an
+# executable `mirror-hook`, by MIRROR_NODE's rule and pattern (CR197): a
+# relative one would resolve against the project the runtime spawned this hook
+# from, and Node would run that project's file. Anything else is noted with its
+# reason, in MIRROR_NODE's words, once a day, and the search goes on without it.
 ENTRY=""
-[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+if [ -n "${MIRROR_BIN:-}" ]; then
+  refused=""
+  case "$MIRROR_BIN" in
+    /*|\\*|[A-Za-z]:[\\/]*)
+      if [ ! -e "$MIRROR_BIN" ]; then refused="missing"
+      elif [ ! -d "$MIRROR_BIN" ]; then refused="not a directory"
+      elif [ ! -f "$MIRROR_BIN/mirror-hook" ] || [ ! -x "$MIRROR_BIN/mirror-hook" ]; then refused="a directory without an executable mirror-hook"
+      else ENTRY="$MIRROR_BIN/mirror-hook"
+      fi
+      ;;
+    *) refused="relative" ;;
+  esac
+  if [ -n "$refused" ]; then
+    note "MIRROR_BIN=${MIRROR_BIN//[$'\r\n']/} is $refused; searching the PATH and the usual places instead" daily
+  fi
+fi
 [ -n "$ENTRY" ] || ENTRY="$(command -v mirror-hook 2>/dev/null || true)"
 for candidate in "$HOME/.nvm/current/bin" /opt/homebrew/bin /usr/local/bin; do
   [ -n "$ENTRY" ] && break

package/plugins/mirror-mind/mcp_config.json

@@ -4,7 +4,7 @@
       "command": "/bin/sh",
       "args": [
         "-c",
-        "mmbin=\"\"; [ -n \"$MIRROR_BIN\" ] && [ -x \"$MIRROR_BIN/mirror\" ] && mmbin=\"$MIRROR_BIN/mirror\"; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
+        "mmbin=\"\"; mmbindir=\"$MIRROR_BIN\"; mmwhy=\"\"; [ -n \"$mmbindir\" ] && case \"$mmbindir\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ ! -e \"$mmbindir\" ]; then mmwhy=\"missing\"; elif [ ! -d \"$mmbindir\" ]; then mmwhy=\"not a directory\"; elif [ ! -f \"$mmbindir/mirror\" ] || [ ! -x \"$mmbindir/mirror\" ]; then mmwhy=\"a directory without an executable mirror\"; else mmbin=\"$mmbindir/mirror\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && printf 'mirror-mind: MIRROR_BIN=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmbindir\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
       ]
     }
   }

package/plugins/mirror-mind/plugin.json

@@ -1,13 +1,13 @@
 {
   "name": "mirror-mind",
   "description": "Mirror Mind — local-first memory and identity for agentic runtimes.",
-  "version": "0.40.0",
+  "version": "0.41.0",
   "mcpServers": {
     "mirror-mind": {
       "command": "/bin/sh",
       "args": [
         "-c",
-        "mmbin=\"\"; [ -n \"$MIRROR_BIN\" ] && [ -x \"$MIRROR_BIN/mirror\" ] && mmbin=\"$MIRROR_BIN/mirror\"; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
+        "mmbin=\"\"; mmbindir=\"$MIRROR_BIN\"; mmwhy=\"\"; [ -n \"$mmbindir\" ] && case \"$mmbindir\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ ! -e \"$mmbindir\" ]; then mmwhy=\"missing\"; elif [ ! -d \"$mmbindir\" ]; then mmwhy=\"not a directory\"; elif [ ! -f \"$mmbindir/mirror\" ] || [ ! -x \"$mmbindir/mirror\" ]; then mmwhy=\"a directory without an executable mirror\"; else mmbin=\"$mmbindir/mirror\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && printf 'mirror-mind: MIRROR_BIN=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmbindir\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; [ -n \"$mmbin\" ] || mmbin=\"$(command -v mirror 2>/dev/null)\"; for mmdir in \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmbin\" ] && break; [ -x \"$mmdir/mirror\" ] && mmbin=\"$mmdir/mirror\"; done; [ -n \"$mmbin\" ] || { echo \"mirror-mind: mirror not found on PATH; the MCP server cannot start. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory.\" >&2; exit 1; }; mmjs=\"$(dirname \"$mmbin\")/node_modules/mirror-mind/bin/mirror.js\"; [ -f \"$mmjs\" ] && mmbin=\"$mmjs\"; mmnode=\"$MIRROR_NODE\"; mmwhy=\"\"; [ -n \"$mmnode\" ] && case \"$mmnode\" in /*|\\\\*|[A-Za-z]:[\\\\/]*) if [ -d \"$mmnode\" ]; then mmwhy=\"a directory\"; elif [ ! -e \"$mmnode\" ]; then mmwhy=\"missing\"; elif [ ! -f \"$mmnode\" ] || [ ! -x \"$mmnode\" ]; then mmwhy=\"not executable\"; fi ;; *) mmwhy=\"relative\" ;; esac; [ -n \"$mmwhy\" ] && { printf 'mirror-mind: MIRROR_NODE=%s is %s; searching the PATH and the usual places instead\\n' \"$(printf '%s' \"$mmnode\" | tr -d '\\r\\n')\" \"$mmwhy\" >&2; mmnode=\"\"; }; [ -n \"$mmnode\" ] || mmnode=\"$(command -v node 2>/dev/null)\"; for mmdir in \"$(dirname \"$mmbin\")\" \"$HOME/.nvm/current/bin\" /opt/homebrew/bin /usr/local/bin; do [ -n \"$mmnode\" ] && break; [ -x \"$mmdir/node\" ] && mmnode=\"$mmdir/node\"; done; [ -n \"$mmnode\" ] || { echo \"mirror-mind: node not found on PATH; the MCP server cannot start. Set MIRROR_NODE.\" >&2; exit 1; }; exec \"$mmnode\" \"$mmbin\" mcp"
       ]
     }
   }