mirror-mind 0.34.0 → 0.36.0

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

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Mirror Mind hook wrapper — GENERATED by scripts/generate_hook_wrappers.sh.
+# Edit the generator, never this file: every agy wrapper shares these bytes
+# and differs only in the hook name and its stdin gate (CV21.DS7.TS2).
+set -uo pipefail
+HOOK="agy:pre-invocation"
+GATE='"invocationNum"[[:space:]]*:[[:space:]]*-?[0-9]*[1-9]'
+
+# agy sends the payload on stdin and blocks its agent loop on this process.
+# Read the payload once; when the gate says this invocation is not ours,
+# answer the empty object without resolving Node at all.
+PAYLOAD="$(cat 2>/dev/null || true)"
+if [ -n "$GATE" ] && printf '%s' "$PAYLOAD" | grep -qE "$GATE"; then
+  printf '{}\n'
+  exit 0
+fi
+
+# This wrapper is the Claude plugin's, and a plugin is copied into Claude
+# Code's own cache: no relative path from here reaches the Mirror tree. It
+# runs the installed `mirror-hook` bin instead, and reads no tree .env.
+REPO_ROOT=""
+
+# A hook never fails the user's turn, and never fails in silence: when it
+# cannot do its job it appends ONE line to <mirror home>/hooks.log and exits
+# 0 — after answering agy's contract, so the agent loop never stalls.
+env_file_value() {
+  [ -f "$2" ] || return 0
+  sed -n -E "s/^[[:space:]]*(export[[:space:]]+)?$1[[:space:]]*=[[:space:]]*//p" "$2" \
+    | tail -n 1 | tr -d "\"'\r"
+}
+env_value() {
+  local value=""
+  if [ -n "${!1+set}" ]; then printf '%s' "${!1}"; return; fi
+  [ -z "$REPO_ROOT" ] || value="$(env_file_value "$1" "$REPO_ROOT/.env")"
+  [ -n "$value" ] || value="$(env_file_value "$1" "${XDG_CONFIG_HOME:-$HOME/.config}/mirror/env")"
+  printf '%s' "$value"
+}
+note() {
+  local home user
+  home="$(env_value MIRROR_HOME)"
+  user="$(env_value MIRROR_USER)"
+  if [ -n "$home" ]; then
+    home="${home/#\~/$HOME}"
+  elif [ -n "$user" ]; then
+    home="$HOME/.mirror-minds/$user"
+    [ -d "$home" ] || [ ! -d "$HOME/.mirror/$user" ] || home="$HOME/.mirror/$user"
+  else
+    return 0
+  fi
+  mkdir -p "$home" 2>/dev/null \
+    && printf '%s %s: %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$HOOK" "$1" >> "$home/hooks.log" 2>/dev/null
+}
+
+# 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.
+ENTRY=""
+[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+[ -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
+  [ -x "$candidate/mirror-hook" ] && ENTRY="$candidate/mirror-hook"
+done
+
+if [ -z "$ENTRY" ]; then
+  note "mirror-hook not found on PATH; hook skipped. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory."
+  exit 0
+fi
+
+NODE="${MIRROR_NODE:-}"
+if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then
+  NODE="$(command -v node 2>/dev/null || true)"
+fi
+for candidate in "$(dirname "$ENTRY")/node" "$HOME/.nvm/current/bin/node" /opt/homebrew/bin/node /usr/local/bin/node; do
+  [ -n "$NODE" ] && break
+  [ -x "$candidate" ] && NODE="$candidate"
+done
+
+if [ -z "$NODE" ]; then
+  printf '{}\n'
+  note "node not found on PATH; hook skipped. Set MIRROR_NODE."
+  exit 0
+fi
+
+# The payload was consumed by the gate read; re-feed it to the entry.
+printf '%s' "$PAYLOAD" | "$NODE" "$ENTRY" "$HOOK" "$@"
+status=$?
+if [ "$status" -ne 0 ]; then
+  printf '{}\n'
+  note "node exited $status before the hook finished ($NODE, $("$NODE" --version 2>/dev/null || echo 'version unknown')); Mirror needs Node 24 or later. Set MIRROR_NODE."
+fi
+exit 0

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

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Mirror Mind hook wrapper — GENERATED by scripts/generate_hook_wrappers.sh.
+# Edit the generator, never this file: every agy wrapper shares these bytes
+# and differs only in the hook name and its stdin gate (CV21.DS7.TS2).
+set -uo pipefail
+HOOK="agy:session-start"
+GATE=''
+
+# agy sends the payload on stdin and blocks its agent loop on this process.
+# Read the payload once; when the gate says this invocation is not ours,
+# answer the empty object without resolving Node at all.
+PAYLOAD="$(cat 2>/dev/null || true)"
+if [ -n "$GATE" ] && printf '%s' "$PAYLOAD" | grep -qE "$GATE"; then
+  printf '{}\n'
+  exit 0
+fi
+
+# This wrapper is the Claude plugin's, and a plugin is copied into Claude
+# Code's own cache: no relative path from here reaches the Mirror tree. It
+# runs the installed `mirror-hook` bin instead, and reads no tree .env.
+REPO_ROOT=""
+
+# A hook never fails the user's turn, and never fails in silence: when it
+# cannot do its job it appends ONE line to <mirror home>/hooks.log and exits
+# 0 — after answering agy's contract, so the agent loop never stalls.
+env_file_value() {
+  [ -f "$2" ] || return 0
+  sed -n -E "s/^[[:space:]]*(export[[:space:]]+)?$1[[:space:]]*=[[:space:]]*//p" "$2" \
+    | tail -n 1 | tr -d "\"'\r"
+}
+env_value() {
+  local value=""
+  if [ -n "${!1+set}" ]; then printf '%s' "${!1}"; return; fi
+  [ -z "$REPO_ROOT" ] || value="$(env_file_value "$1" "$REPO_ROOT/.env")"
+  [ -n "$value" ] || value="$(env_file_value "$1" "${XDG_CONFIG_HOME:-$HOME/.config}/mirror/env")"
+  printf '%s' "$value"
+}
+note() {
+  local home user
+  home="$(env_value MIRROR_HOME)"
+  user="$(env_value MIRROR_USER)"
+  if [ -n "$home" ]; then
+    home="${home/#\~/$HOME}"
+  elif [ -n "$user" ]; then
+    home="$HOME/.mirror-minds/$user"
+    [ -d "$home" ] || [ ! -d "$HOME/.mirror/$user" ] || home="$HOME/.mirror/$user"
+  else
+    return 0
+  fi
+  mkdir -p "$home" 2>/dev/null \
+    && printf '%s %s: %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$HOOK" "$1" >> "$home/hooks.log" 2>/dev/null
+}
+
+# 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.
+ENTRY=""
+[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+[ -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
+  [ -x "$candidate/mirror-hook" ] && ENTRY="$candidate/mirror-hook"
+done
+
+if [ -z "$ENTRY" ]; then
+  note "mirror-hook not found on PATH; hook skipped. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory."
+  exit 0
+fi
+
+NODE="${MIRROR_NODE:-}"
+if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then
+  NODE="$(command -v node 2>/dev/null || true)"
+fi
+for candidate in "$(dirname "$ENTRY")/node" "$HOME/.nvm/current/bin/node" /opt/homebrew/bin/node /usr/local/bin/node; do
+  [ -n "$NODE" ] && break
+  [ -x "$candidate" ] && NODE="$candidate"
+done
+
+if [ -z "$NODE" ]; then
+  printf '{}\n'
+  note "node not found on PATH; hook skipped. Set MIRROR_NODE."
+  exit 0
+fi
+
+# The payload was consumed by the gate read; re-feed it to the entry.
+printf '%s' "$PAYLOAD" | "$NODE" "$ENTRY" "$HOOK" "$@"
+status=$?
+if [ "$status" -ne 0 ]; then
+  printf '{}\n'
+  note "node exited $status before the hook finished ($NODE, $("$NODE" --version 2>/dev/null || echo 'version unknown')); Mirror needs Node 24 or later. Set MIRROR_NODE."
+fi
+exit 0

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

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# Mirror Mind hook wrapper — GENERATED by scripts/generate_hook_wrappers.sh.
+# Edit the generator, never this file: every agy wrapper shares these bytes
+# and differs only in the hook name and its stdin gate (CV21.DS7.TS2).
+set -uo pipefail
+HOOK="agy:stop"
+GATE=''
+
+# agy sends the payload on stdin and blocks its agent loop on this process.
+# Read the payload once; when the gate says this invocation is not ours,
+# answer the empty object without resolving Node at all.
+PAYLOAD="$(cat 2>/dev/null || true)"
+if [ -n "$GATE" ] && printf '%s' "$PAYLOAD" | grep -qE "$GATE"; then
+  printf '{}\n'
+  exit 0
+fi
+
+# This wrapper is the Claude plugin's, and a plugin is copied into Claude
+# Code's own cache: no relative path from here reaches the Mirror tree. It
+# runs the installed `mirror-hook` bin instead, and reads no tree .env.
+REPO_ROOT=""
+
+# A hook never fails the user's turn, and never fails in silence: when it
+# cannot do its job it appends ONE line to <mirror home>/hooks.log and exits
+# 0 — after answering agy's contract, so the agent loop never stalls.
+env_file_value() {
+  [ -f "$2" ] || return 0
+  sed -n -E "s/^[[:space:]]*(export[[:space:]]+)?$1[[:space:]]*=[[:space:]]*//p" "$2" \
+    | tail -n 1 | tr -d "\"'\r"
+}
+env_value() {
+  local value=""
+  if [ -n "${!1+set}" ]; then printf '%s' "${!1}"; return; fi
+  [ -z "$REPO_ROOT" ] || value="$(env_file_value "$1" "$REPO_ROOT/.env")"
+  [ -n "$value" ] || value="$(env_file_value "$1" "${XDG_CONFIG_HOME:-$HOME/.config}/mirror/env")"
+  printf '%s' "$value"
+}
+note() {
+  local home user
+  home="$(env_value MIRROR_HOME)"
+  user="$(env_value MIRROR_USER)"
+  if [ -n "$home" ]; then
+    home="${home/#\~/$HOME}"
+  elif [ -n "$user" ]; then
+    home="$HOME/.mirror-minds/$user"
+    [ -d "$home" ] || [ ! -d "$HOME/.mirror/$user" ] || home="$HOME/.mirror/$user"
+  else
+    return 0
+  fi
+  mkdir -p "$home" 2>/dev/null \
+    && printf '%s %s: %s\n' "$(date -u +%Y-%m-%dT%H:%M:%SZ)" "$HOOK" "$1" >> "$home/hooks.log" 2>/dev/null
+}
+
+# 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.
+ENTRY=""
+[ -n "${MIRROR_BIN:-}" ] && [ -x "$MIRROR_BIN/mirror-hook" ] && ENTRY="$MIRROR_BIN/mirror-hook"
+[ -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
+  [ -x "$candidate/mirror-hook" ] && ENTRY="$candidate/mirror-hook"
+done
+
+if [ -z "$ENTRY" ]; then
+  note "mirror-hook not found on PATH; hook skipped. Install mirror-mind (npm install -g mirror-mind) or set MIRROR_BIN to its bin directory."
+  exit 0
+fi
+
+NODE="${MIRROR_NODE:-}"
+if [ -z "$NODE" ] || [ ! -x "$NODE" ]; then
+  NODE="$(command -v node 2>/dev/null || true)"
+fi
+for candidate in "$(dirname "$ENTRY")/node" "$HOME/.nvm/current/bin/node" /opt/homebrew/bin/node /usr/local/bin/node; do
+  [ -n "$NODE" ] && break
+  [ -x "$candidate" ] && NODE="$candidate"
+done
+
+if [ -z "$NODE" ]; then
+  printf '{}\n'
+  note "node not found on PATH; hook skipped. Set MIRROR_NODE."
+  exit 0
+fi
+
+# The payload was consumed by the gate read; re-feed it to the entry.
+printf '%s' "$PAYLOAD" | "$NODE" "$ENTRY" "$HOOK" "$@"
+status=$?
+if [ "$status" -ne 0 ]; then
+  printf '{}\n'
+  note "node exited $status before the hook finished ($NODE, $("$NODE" --version 2>/dev/null || echo 'version unknown')); Mirror needs Node 24 or later. Set MIRROR_NODE."
+fi
+exit 0

package/plugins/mirror-mind/hooks.json

@@ -0,0 +1,26 @@
+{
+  "mirror-mind": {
+    "enabled": true,
+    "SessionStart": [
+      {
+        "type": "command",
+        "command": "agy/session-start.sh",
+        "timeout": 60
+      }
+    ],
+    "PreInvocation": [
+      {
+        "type": "command",
+        "command": "agy/pre-invocation.sh",
+        "timeout": 15
+      }
+    ],
+    "Stop": [
+      {
+        "type": "command",
+        "command": "agy/stop.sh",
+        "timeout": 30
+      }
+    ]
+  }
+}

package/plugins/mirror-mind/mcp_config.json

@@ -0,0 +1,11 @@
+{
+  "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; }; mmnode=\"$MIRROR_NODE\"; [ -n \"$mmnode\" ] && [ -x \"$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

@@ -0,0 +1,14 @@
+{
+  "name": "mirror-mind",
+  "description": "Mirror Mind — local-first memory and identity for agentic runtimes.",
+  "version": "0.36.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; }; mmnode=\"$MIRROR_NODE\"; [ -n \"$mmnode\" ] && [ -x \"$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/rules/AGENTS.md

@@ -0,0 +1,189 @@
+# Mirror Mind — Operating Instructions
+
+<!-- This file ships in the mirror-mind package and is read by every runtime:
+     Pi and Codex read it from the project root natively, Claude Code through
+     the @AGENTS.md import in CLAUDE.md, Antigravity as the plugin's rules, and
+     an installed package's Pi session receives it from the extension
+     (CV22.DS10.US3, D13).
+     It holds nothing about this repository; that is CLAUDE.md's part. -->
+
+---
+
+## Mirror Operating Instructions
+
+Applies to all sessions, regardless of project.
+
+### Operating Modes
+
+The mirror operates in four modes, chosen automatically based on context:
+Mirror, Builder, Explorer, and Soul.
+
+Each skill below is named three ways: `/mm-<skill>` in Pi and Grok Build,
+`$mm-<skill>` in Codex, `/mm:<skill>` in Claude Code. A **plugin** install prefixes the plugin's
+name — `/mirror-mind:mm:<skill>` in Claude Code's menu and in Antigravity,
+`$mirror-mind:mm:<skill>` in Codex, `mirror-mind:mm-<skill>` as the skill's own
+name — and the forms below refer to the same skill.
+
+**Mirror Mode** — activate for: life decisions, feelings, business strategy,
+writing, mentoring, health, existential questions, sensemaking, psychological
+tensions, class preparation, product launches, or any topic asking for personal
+reflection or positioning.
+
+How to operate: load the mirror skill (`/mm-mirror`, `$mm-mirror`, or
+`/mm:mirror`). Load identity, route persona, search attachments, answer in first
+person, and record the response.
+
+**Builder Mode** — activate for: code, project structure, YAML editing, bugs,
+implementation, architecture, or any software engineering task.
+
+How to operate: read code, edit files, run commands, propose technical
+solutions, keep docs updated when code changes. For a journey, use `/mm-build
+<slug>` / `$mm-build <slug>` / `/mm:build <slug>` — loads journey context and
+project docs.
+
+**Explorer Mode** — activate for the uncertain middle before construction:
+exploring a possibility space, holding uncertainty before committing to build,
+developing an Exploratory Story, surfacing attractors, proposing small
+experiments, or preparing a Builder handoff.
+
+How to operate: use `/mm-explore <slug>` / `$mm-explore <slug>` / `/mm:explore
+<slug>` to activate Explorer Mode for a journey and resume the active Exploratory
+Story when one exists. Follow `.pi/skills/mm-explore/SKILL.md`: render required
+story surfaces before interpretation, thicken the story as the narrative changes,
+and keep exploration durable. Explorer Mode preserves uncertainty — it does not
+implement. For operational mutation requests, name the `△ EXPLORER → BUILDER
+BOUNDARY` and route them through Builder Mode via an explicit handoff. Deactivate
+with `/mm-explore deactivate`, which returns to Mirror Mode while preserving
+sticky journey context.
+
+**Soul Mode** — activate when the user asks to enter Soul Mode, open Soul Mode,
+or continue an active Soul Mode ritual.
+
+How to operate: use `/mm-soul [slug]` / `$mm-soul [slug]` / `/mm:soul [slug]`
+to render the entry surface. While Soul Mode is active, follow
+`.pi/skills/mm-soul/SKILL.md`: listen to the user's answer as living field,
+withhold Possible Listenings when the material is thin, and when living matter
+appears call the front door's `soul listen ...` (the exact invocation is in the
+skill) to render the Possible Listenings surface at the end of the response. This renderer call is required
+Soul Mode behavior, not optional tool use. Soul Mode must not mutate files,
+implement stories, run implementation commands, package releases, or change
+project state. For operational requests, name the `☾ SOUL → BUILDER BOUNDARY`
+and ask whether to switch to Builder Mode for the same journey.
+
+Builder activation boundary: activating Builder Mode or loading a journey is
+context setup only. After loading the context and required docs, stop and ask
+what work should be done next. Do not edit files, create tests, run
+implementation, start TDD, or mutate project state until the user gives an
+explicit implementation or documentation instruction, such as implement, fix,
+edit, create, run tests, or names a specific story to execute. Context
+activation is not execution consent.
+
+Ariad surface transport invariant: when command output contains marked Ariad
+surface blocks (`<<<ARIAD:...>>>` through `<<<END:...>>>`), preserve every marked
+block verbatim in the assistant response before commentary. Do not summarize,
+translate, reorder, trim, rewrap, re-indent, reformat, or replace marked surfaces
+with prose. This is a general rendering rule for Ariad surfaces, not a
+phase-specific behavior.
+
+**Ambiguity:** if the mode is unclear, ask whether the user wants personal
+reflection or project construction.
+
+**Journey Status** — shortcut within Mirror Mode. Activate when the user asks
+"How are we doing?", "What's the status of X?", or any question about progress
+or roadmap. Dispatch to `/mm-journey` or `/mm-journeys`. When the user asks for
+the journey list in natural language, use `/mm-journeys` and preserve its
+hierarchical rendering without flattening or reformatting it.
+
+**Commits:** use descriptive English commit messages. Explain the WHY, not just
+what was done. Prefer small commits with clear review boundaries.
+
+### Ego-Persona Model
+
+The mirror has one voice: the ego. Personas are specialized lenses activated by
+the ego according to context.
+
+**Automatic routing:** activate a persona when the topic clearly belongs to a
+specialized domain, the depth required exceeds the generic ego repertoire, or
+the user explicitly asks for a persona.
+
+**Routing protocol:** persona routing is data-driven. Each persona in the
+database carries `routing_keywords` and a routing descriptor. At runtime,
+`detectPersona` (`ts/src/persona/detectPersona.ts`) scores the query against
+those keywords. If no persona scores above threshold, the ego answers alone. To
+inspect active routing:
+`mirror detect-persona "<query>"`.
+
+**Signature format:**
+
+When the ego answers alone — no signature.
+
+When a persona is active:
+```text
+◇ persona-name
+
+[first-person answer, unified voice]
+```
+
+When switching personas:
+```text
+◇ product-designer
+
+[analysis...]
+
+◇ therapist
+
+[reflection...]
+```
+
+Rules: `◇` plus persona name on its own line; voice stays first person and unified.
+
+### Hard Constraints
+
+- **Truth:** do not invent data. If uncertain, say so.
+- **Service:** intellectual partner, not task executor. Question, refine, align —
+  do not execute without thinking.
+
+### Available Skills
+
+**Core modes:**
+- `mm-mirror` — activates Mirror Mode — `.pi/skills/mm-mirror/SKILL.md`
+- `mm-build` — activates Builder Mode for a journey — `.pi/skills/mm-build/SKILL.md`
+- `mm-explore` — activates Explorer Mode for a journey — `.pi/skills/mm-explore/SKILL.md`
+- `mm-soul` — activates Soul Mode ritual entry — `.pi/skills/mm-soul/SKILL.md`
+
+**Journeys and tasks:**
+- `mm-journeys` — compact journey list — `.pi/skills/mm-journeys/SKILL.md`
+- `mm-journey` — detailed journey status — `.pi/skills/mm-journey/SKILL.md`
+- `mm-tasks` — task management by journey — `.pi/skills/mm-tasks/SKILL.md`
+- `mm-week` — weekly planning — `.pi/skills/mm-week/SKILL.md`
+
+**Memory and inspection:**
+- `mm-memories` — recorded memories — `.pi/skills/mm-memories/SKILL.md`
+- `mm-conversations` — recent conversations list — `.pi/skills/mm-conversations/SKILL.md`
+- `mm-recall` — load messages from a previous conversation — `.pi/skills/mm-recall/SKILL.md`
+
+**Content:**
+- `mm-journal` — personal journal entry — `.pi/skills/mm-journal/SKILL.md`
+
+**Identity:**
+- `mm-seed` — seed identity YAML files into the database — `.pi/skills/mm-seed/SKILL.md`
+- `mm-identity` — read and update identity in the database — `.pi/skills/mm-identity/SKILL.md`
+
+**Session control:**
+- `mm-mute` — toggle conversation logging — `.pi/skills/mm-mute/SKILL.md`
+- `mm-new` — start a new conversation — `.pi/skills/mm-new/SKILL.md`
+- `mm-discard` — discard the current conversation before quitting — `.pi/skills/mm-discard/SKILL.md`
+
+**Memory cultivation:**
+- `mm-consolidate` — scan memories for patterns and propose consolidation — `.pi/skills/mm-consolidate/SKILL.md`
+- `mm-shadow` — surface and promote shadow-layer observations — `.pi/skills/mm-shadow/SKILL.md`
+
+**Utilities:**
+- `mm-consult` — ask other LLMs through OpenRouter — `.pi/skills/mm-consult/SKILL.md`
+- `mm-backup` — memory database backup — `.pi/skills/mm-backup/SKILL.md`
+- `mm-welcome` — render the state-aware welcome card on demand — `.pi/skills/mm-welcome/SKILL.md`
+- `mm-release-notes` — show Mirror Mind release notes — `.pi/skills/mm-release-notes/SKILL.md`
+- `mm-update` — update the local Mirror runtime — `.pi/skills/mm-update/SKILL.md`
+- `mm-help` — list available commands — `.pi/skills/mm-help/SKILL.md`
+
+Full command reference: [REFERENCE.md](REFERENCE.md)

package/plugins/mirror-mind/skills/mm-build/SKILL.md

@@ -10,7 +10,7 @@ Activates Builder Mode for a specific journey. Loads identity context and projec
 
 ## Usage
 
-Pi and Gemini CLI:
+Pi:
 
 ```
 /mm-build <journey-slug>

package/ts/src/conversation/agyTranscript.ts

@@ -0,0 +1,105 @@
+// The agy transcript reader (CV21.DS7.TS3).
+//
+// Antigravity's hook payloads carry no prompt or reply text (DS12.TS3 L7),
+// so logging reads the JSONL transcript agy writes. The step shapes are
+// probed from real agy 1.4.2 transcripts (the US1/TS2/TS3 probe discipline;
+// evidence/transcript-shape-20261018.md):
+//
+//   * a user turn is a `USER_INPUT` step (`source: USER_EXPLICIT`) whose
+//     content string wraps the request in `<USER_REQUEST>…</USER_REQUEST>`,
+//     followed by `<ADDITIONAL_METADATA>…`;
+//   * the model's answer is the `PLANNER_RESPONSE` step(s) (`source: MODEL`).
+//     MOST of these are EMPTY — intermediate tool steps — so the reply is
+//     the non-empty response text in the turn, not every PLANNER_RESPONSE.
+//     (The plan guessed `AGENT_MESSAGE`; the probe corrected both the type
+//     and the emptiness.)
+//
+// A turn runs from one `USER_INPUT` to just before the next. `step_index` is
+// a monotonic per-conversation ordinal; `lastStepIndex` is the turn's
+// high-water mark, which the Stop handler stores so a re-fired Stop logs
+// nothing new.
+
+import { parseJsonl } from "#conversation/transcriptBackfill.ts";
+
+export interface AgyTurn {
+  readonly userText: string;
+  readonly replyText: string;
+  /** The highest step_index this turn logged: the idempotency high-water mark. */
+  readonly lastStepIndex: number;
+}
+
+function stringField(entry: unknown, key: string): string {
+  if (typeof entry !== "object" || entry === null) return "";
+  const value = (entry as Record<string, unknown>)[key];
+  return typeof value === "string" ? value : "";
+}
+
+function numberField(entry: unknown, key: string): number {
+  if (typeof entry !== "object" || entry === null) return -1;
+  const value = (entry as Record<string, unknown>)[key];
+  return typeof value === "number" ? value : -1;
+}
+
+const USER_REQUEST = /<USER_REQUEST>\s*([\s\S]*?)\s*<\/USER_REQUEST>/;
+
+/** The request body agy wraps the user's words in, or the whole string. */
+export function extractUserRequest(content: string): string {
+  const match = USER_REQUEST.exec(content);
+  return (match ? match[1] : content).trim();
+}
+
+/**
+ * Join the turn's non-empty reply parts into one string, the same rule the
+ * Claude reader's `assistantText` uses (trimmed, blank-line separated).
+ * Shared so "how parts become one reply" lives in one place.
+ */
+export function joinReplyParts(parts: readonly string[]): string {
+  return parts
+    .map((part) => part.trim())
+    .filter((part) => part.length > 0)
+    .join("\n\n");
+}
+
+/**
+ * The transcript's completed turns, in order. Each pairs the user's request
+ * with the model's reply and carries the turn's high-water `step_index`.
+ * A turn with no reply text yet (the model has not answered) is omitted:
+ * the Stop handler logs it on the Stop that follows the answer.
+ */
+export function readAgyTurns(transcriptPath: string): AgyTurn[] {
+  let entries: unknown[];
+  try {
+    entries = parseJsonl(transcriptPath);
+  } catch {
+    return [];
+  }
+
+  const turns: AgyTurn[] = [];
+  let userText: string | null = null;
+  let replyParts: string[] = [];
+  let lastStepIndex = -1;
+
+  const flush = () => {
+    if (userText === null) return;
+    const replyText = joinReplyParts(replyParts);
+    if (replyText) turns.push({ userText, replyText, lastStepIndex });
+    userText = null;
+    replyParts = [];
+  };
+
+  for (const entry of entries) {
+    const type = stringField(entry, "type");
+    if (type === "USER_INPUT") {
+      flush();
+      userText = extractUserRequest(stringField(entry, "content"));
+      lastStepIndex = numberField(entry, "step_index");
+    } else if (type === "PLANNER_RESPONSE" && userText !== null) {
+      const content = stringField(entry, "content").trim();
+      const stepIndex = numberField(entry, "step_index");
+      if (stepIndex > lastStepIndex) lastStepIndex = stepIndex;
+      if (content) replyParts.push(content);
+    }
+  }
+  flush();
+  return turns;
+}

package/ts/src/conversation/commandTurn.ts

@@ -29,7 +29,7 @@
 // One rule for every runtime: a Claude Code user who types `$mm-journeys`,
 // which Claude Code does not understand, is still invoking a skill, and that
 // turn is not conversation either. The rule has one home for every hook that
-// runs in our process (the Claude-family logger, the Gemini hook); the Pi
+// runs in our process (the Claude-family logger, agy's Stop); the Pi
 // extension, a separate process in Pi's file, keeps its own `/` check.
 
 const SKILL_SEGMENT = "[a-z][a-z0-9_-]*";

package/ts/src/conversation/deferredCloseTail.ts

@@ -5,8 +5,8 @@
 // (extraction, then title/summary/tags). Some runtimes give a SessionEnd hook
 // less time than one model call: Codex runs it synchronously under a 1 s
 // default (DS12.TS2 L2; DS2's live `/hooks` table), Grok under 1.5 s
-// (DS12.TS4). Pi and Gemini CLI already close without extraction at exit and
-// let the next session start extract (`session-end-pi`). On a runtime that
+// (DS12.TS4). Pi already closes without extraction at exit and
+// lets the next session start extract (`session-end-pi`). On a runtime that
 // bounds the hook, the shared Claude-family `session-end` does the same, and a
 // little more: it also skips the metadata finalization, and flags the
 // conversation so the next start's maintenance finishes it.