metame-cli 1.5.0 → 1.5.1

package/README.md

@@ -24,34 +24,18 @@ No cloud. Your machine, your data.
 curl -fsSL https://raw.githubusercontent.com/Yaron9/MetaMe/main/install.sh | bash
 ```
 
-**Already have Node.js ≥ 22.5:**
-```bash
-npm install -g metame-cli
-metame
-```
-
-**Windows (PowerShell):**
-```powershell
-npm install -g metame-cli
-metame
-```
-
 ---
 
-> ### 🚀 v1.4.34 — Mentor Mode Step 4 + Distiller/Memory Closed Loop
+> ### 🚀 v1.5.0 — Dynamic Engine Default + Distill Coupling
 >
-> - **Multi-engine runtime adapter (MVP)**: daemon now supports engine routing by project (`project.engine`) with shared execution flow for Claude/Codex.
-> - **Codex session continuity**: supports `exec`/`resume`, thread id backfill, one-shot resume fallback (max once per 10 minutes per chat), and auth/rate-limit error mapping.
-> - **Agent engine inference**: natural-language agent creation can infer `codex`; default `claude` keeps zero-regression (no `engine` field persisted).
-> - **6-dimension soul schema**: cognitive profile upgraded from key-value pairs to a structured 67-field model covering Values, Drive, Cognition Style, Stress & Shadow, Relational, and Identity Narrative — with tier-based lock protection.
-> - **Mentor mode hooks**: pre-flight emotion breaker, context-time mentor prompt, and post-flight reflection debt registration are wired into daemon flow.
-> - **Distiller Step 4**: competence signals now merge into `user_competence_map` (upgrade-by-default, downgrade only with explicit evidence).
-> - **Memory extraction labels**: `memory-extract` writes concept labels into `fact_labels` (linked by fact id from `saveFacts().savedFacts`).
-> - **Nightly closed loop**: nightly reflection writes back `synthesized_insight` facts and generates `knowledge_capsule` documents + facts.
-> - **Postmortem artifacts**: significant sessions now produce `postmortem` markdown and `bug_lesson` facts.
-> - **Memory index**: auto-generated global index of all memory documents for instant retrieval.
-> - **Auto-provisioning**: first run automatically deploys default CLAUDE.md, docs, and `dispatch_to` — zero manual setup.
-> - **Token budget tracking**: daily token usage monitoring with per-category breakdown and 80% warning threshold.
+> - **Dynamic default engine**: auto-detects installed CLI (claude/codex) at startup; pure-codex users work out of the box with zero config.
+> - **`/engine` command**: switch global default engine from mobile (`/engine codex`), with three-layer priority: `project.engine > /engine setting > auto-detect`.
+> - **Engine–distill coupling**: switching engine auto-pairs the distill model (claude→haiku, codex→gpt-5.1-codex-mini) and distill binary.
+> - **Engine-aware distill**: `callDistillModel` now routes through the correct CLI binary and parses codex JSON stream output.
+> - **`/doctor` engine checks**: health check now validates CLI availability against the configured default engine.
+> - **Multi-engine runtime adapter**: daemon supports engine routing by project (`project.engine`) with shared execution flow for Claude/Codex.
+> - **Codex session continuity**: supports `exec`/`resume`, thread id backfill, one-shot resume fallback, and auth/rate-limit error mapping.
+> - **Mentor mode hooks**: pre-flight emotion breaker, context-time mentor prompt, and post-flight reflection debt registration.
 > - **Multi-user ACL**: role-based permissions (admin / member / stranger) with binding protection.
 > - **Windows native support**: cross-platform path handling, Named Pipes IPC, GBK-safe encoding.
 >
@@ -220,116 +204,74 @@ task outcome/failure → skill signal buffer
 
 ---
 
-## Quick Start
+## Install
 
-```bash
-curl -fsSL https://raw.githubusercontent.com/Yaron9/MetaMe/main/install.sh | bash
-```
-
-**Already have Node.js ≥ 22.5:**
-```bash
-npm install -g metame-cli
-metame
-```
+MetaMe is the orchestration layer. Claude Code and Codex are the engines. You install them together.
 
-> **First run auto-provisioning:** MetaMe automatically deploys a default `CLAUDE.md`, documentation files, and the `dispatch_to` tool to `~/.metame/`. No manual setup needed.
+### One-liner by user type
 
-**Setup guide (3 minutes):**
-
-| Step | What to do | What happens |
-|------|-----------|-------------|
-| 1. Log in to your engine | Run `claude` (Claude user) or `codex login` (Codex user) | Your local CLI engine is ready |
-| 2. Launch MetaMe | Run `metame` (Claude) or `metame codex` (Codex) | Opens a MetaMe-initialized session |
-| 3. Genesis Interview | Just chat — MetaMe will automatically start a deep soul interview on first run | Builds `~/.claude_profile.yaml` (6-dimension cognitive profile) |
-| 4. Connect phone | Say "help me set up mobile access" or "connect my phone" | Interactive wizard for Telegram/Feishu bot setup → `~/.metame/daemon.yaml` |
-| 5. Start daemon | `metame start` | Background daemon launches, bot goes online |
-| 6. Register with system | macOS: `metame daemon install-launchd` · Windows: `metame daemon install-task-scheduler` · Linux: see below | Always-on, crash recovery |
-
-> **First time?** Just run `metame` and talk naturally. The interview and setup are conversational — no commands to memorize.
-
-**Update MetaMe:**
-```bash
-npm install -g metame-cli
-```
-
-### Install Path By User Type
-
-**Claude Code only (plugin path, one-liner):**
-```bash
-claude plugin install github:Yaron9/MetaMe/plugin
-```
-
-**Claude Code only (npm CLI path, one-liner):**
-```bash
-npm install -g @anthropic-ai/claude-code metame-cli && claude && metame
-```
+| You use | Install command | First login |
+|---------|----------------|-------------|
+| **Claude Code** | `npm install -g @anthropic-ai/claude-code metame-cli` | `claude` |
+| **Codex** | `npm install -g @openai/codex metame-cli` | `codex login` |
+| **Both** | `npm install -g @anthropic-ai/claude-code @openai/codex metame-cli` | `claude` + `codex login` |
+| **Claude plugin** (no npm) | `claude plugin install github:Yaron9/MetaMe/plugin` | `claude` |
 
-**Codex only (CLI path, one-liner):**
-```bash
-npm install -g @openai/codex metame-cli && codex login && metame codex
-```
+> **No Node.js?** Run `curl -fsSL https://raw.githubusercontent.com/Yaron9/MetaMe/main/install.sh | bash` — it installs Node + MetaMe for you.
+>
+> **Windows?** Use PowerShell/CMD natively. WSL has proxy and path issues.
 
-**Claude + Codex (one-liner):**
-```bash
-npm install -g @anthropic-ai/claude-code @openai/codex metame-cli
-```
+### Setup (3 minutes)
 
-Then run `claude` once (Claude login), `codex login` once (Codex login), and use:
-- `metame` for Claude
-- `metame codex` for Codex
+| Step | What to do |
+|------|-----------|
+| 1. Launch | `metame` (Claude) or `metame codex` (Codex) |
+| 2. Genesis Interview | Just chat — MetaMe auto-starts a deep soul interview on first run → builds `~/.claude_profile.yaml` |
+| 3. Connect phone | Say "help me set up mobile access" → interactive Telegram/Feishu bot wizard |
+| 4. Start daemon | `metame start` → background daemon launches, bot goes online |
+| 5. Register with OS | macOS: `metame daemon install-launchd` · Windows: `metame daemon install-task-scheduler` |
 
-> `metame-cli` is engine-agnostic. It does not bundle Claude or Codex.  
-> You install the engine(s) separately, and MetaMe routes/launches them.
+> **First time?** Just run `metame` and talk naturally. Everything is conversational.
 
-### Install FAQ
+### Create your first Agent
 
-- **Does Claude plugin mode support daemon + phone access?** Yes. Plugin mode can start the daemon (via `SessionStart` after `daemon.yaml` exists), and phone access works while the daemon is running.
-- **Does `npm install -g metame-cli` install Claude or Codex?** No. It only installs MetaMe. Install `@anthropic-ai/claude-code` and/or `@openai/codex` separately.
-- **If I only install one engine, does MetaMe still work?** Yes. MetaMe will run on the installed engine. `/doctor` marks the non-default missing engine as warning, not hard failure.
+1. In any existing group, say: `Create an agent, directory ~/xxx, responsible for xxx`
+2. Bot replies: Agent created — **send `/activate` in your new group to bind it**
+3. Create a new group, add the bot, send `/activate` → binding complete
 
-### Uninstall (CLI Path)
+> Want more Agents? Repeat the flow. Each group = independent AI workspace.
 
-```bash
-metame stop
-npm uninstall -g metame-cli
-```
+### Update / Uninstall
 
-Codex-only cleanup:
 ```bash
-npm uninstall -g metame-cli @openai/codex
-```
+# Update
+npm install -g metame-cli
 
-Claude-only cleanup:
-```bash
-npm uninstall -g metame-cli @anthropic-ai/claude-code
-```
+# Uninstall
+metame stop && npm uninstall -g metame-cli
 
-Optional data cleanup:
-```bash
+# Optional: remove data
 rm -rf ~/.metame ~/.claude_profile.yaml
 ```
 
 Optional service cleanup:
 - macOS: `launchctl bootout gui/$(id -u) ~/Library/LaunchAgents/com.metame.daemon.plist && rm -f ~/Library/LaunchAgents/com.metame.daemon.plist`
 - Windows: `schtasks /delete /tn "MetaMe-Daemon" /f`
-- Linux/WSL(systemd): `systemctl --user disable --now metame && rm -f ~/.config/systemd/user/metame.service`
-
-> **What does system registration mean?**
-> Once registered, MetaMe runs in the background automatically — screen locked, lid closed, woken from sleep — as long as the machine is on. Scheduled tasks fire on time. No terminal window needed.
+- Linux/WSL: `systemctl --user disable --now metame && rm -f ~/.config/systemd/user/metame.service`
 
-**Windows — register with Task Scheduler:**
-
-```powershell
-metame daemon install-task-scheduler
-```
+### Platform notes
 
-> The daemon auto-starts at login. Remove with: `schtasks /delete /tn "MetaMe-Daemon" /f`
+<details>
+<summary>Windows</summary>
 
-> **Windows notes:** Emoji display uses ASCII fallback (`[OK]`, `[FAIL]`) for GBK terminal compatibility. Named Pipes replace Unix sockets for IPC. `/mac` commands are not available.
+- Emoji auto-degrades to ASCII (`[OK]`, `[FAIL]`) for GBK compatibility
+- IPC uses Named Pipes instead of Unix sockets
+- `/mac` commands are not available
+- **Install natively in PowerShell/CMD, not via WSL**
+</details>
 
-> **Windows users: install natively, not via WSL.** WSL often fails to inherit the host's network proxy (causing npm install and Claude API timeouts), has path mapping issues, and process management doesn't interoperate. `npm install -g metame-cli` directly in PowerShell/CMD is the most reliable approach.
-
-**WSL2 / Linux — register with systemd:**
+<details>
+<summary>WSL2 / Linux — systemd registration</summary>
 
 ```bash
 cat > ~/.config/systemd/user/metame.service << 'EOF'
@@ -350,17 +292,15 @@ systemctl --user enable metame
 systemctl --user start metame
 ```
 
-> WSL2 requires systemd enabled first: add `[boot]\nsystemd=true` to `/etc/wsl.conf`, then restart WSL.
+> Requires systemd enabled: add `[boot]\nsystemd=true` to `/etc/wsl.conf`, then restart WSL.
 
-> **WSL limitation:** `/mac` commands (macOS AppleScript/JXA automation) are not available.
+</details>
 
-**Create your first Agent:**
+### FAQ
 
-1. In any existing group, say: `Create an agent, directory ~/xxx, responsible for xxx`
-2. Bot replies: ✅ Agent created — **send `/activate` in your new group to bind it**
-3. Create a new group, add the bot, send `/activate` → binding complete
-
-> Want more Agents? Repeat: create in any group → new target group → `/activate`. Each group = independent AI workspace.
+- **Does plugin mode support daemon + phone?** Yes. Plugin auto-starts daemon when `daemon.yaml` exists.
+- **Does MetaMe bundle Claude or Codex?** No. `metame-cli` is engine-agnostic — you install engine(s) separately.
+- **One engine only?** Works fine. `/doctor` marks the missing engine as warning, not failure.
 
 ---
 
@@ -605,21 +545,9 @@ For day-2 operations and troubleshooting (engine routing, codex login/rate-limit
 
 ## Plugin
 
-Install directly into Claude Code without npm:
-
-```bash
-claude plugin install github:Yaron9/MetaMe/plugin
-```
-
-Includes: cognitive profile injection, daemon (Telegram/Feishu), heartbeat tasks, layered memory, all mobile commands, slash commands (`/metame:evolve`, `/metame:daemon`, `/metame:refresh`, etc.).
-
-**Current behavior (code-aligned):**
-- Plugin auto-starts daemon on Claude `SessionStart` (if `~/.metame/daemon.yaml` exists).
-- Daemon runs detached; phone access works while daemon is running.
-- Plugin path does **not** auto-register OS service (launchd/task-scheduler/systemd). After reboot, open Claude once or run daemon start manually.
+Install directly into Claude Code without npm: `claude plugin install github:Yaron9/MetaMe/plugin`
 
-Use the plugin if you want zero npm-global setup and Claude-integrated bootstrap.  
-Use npm CLI (`metame-cli`) if you want explicit system-service management and CLI-first operations.
+All features included. Plugin auto-starts daemon on `SessionStart` (if `daemon.yaml` exists). Does **not** auto-register OS service — after reboot, open Claude once or start daemon manually.
 
 ## Contributing