metame-cli 1.3.17 → 1.3.20

package/README.md

@@ -54,6 +54,10 @@
 * **🏥 Emergency Recovery (v1.3.13):** `/doctor` interactive diagnostics with one-tap fix buttons, `/sh` direct shell access from your phone (bypasses Claude entirely — the lifeline when everything else is broken), automatic config backup before any setting change, `/fix` to restore last known good config. `/model` interactive model switcher with auto-backup.
 * **🌐 Browser Automation (v1.3.15):** Native Playwright MCP integration — auto-registered on first run. Every MetaMe user gets browser control capability out of the box. Combined with Skills, enables workflows like automated podcast publishing, form filling, and web scraping.
 * **📂 Interactive File Browser (v1.3.15):** `/list` shows clickable button cards — folders expand inline, files download on tap. Folder buttons survive daemon restarts (absolute paths, no expiry). Zero token cost.
+* **🔀 Parallel Multi-Agent Chats (v1.3.19):** Assign each agent its own dedicated Feishu/Telegram group. Messages in different groups execute in parallel — no waiting for each other. Route `chatId → agent` via `chat_agent_map` in `daemon.yaml`. Create a new group, send `/bind <name>` to register it instantly.
+* **🔧 Config Hot-Reload Fix (v1.3.19):** `allowed_chat_ids` is now read dynamically on every message — no restart needed after editing `daemon.yaml`. `/fix` config restore now merges current `chatId` settings so manually-added groups are never lost.
+* **🛡️ Daemon Auto-Restart via LaunchAgent (v1.3.19):** MetaMe's npm daemon is now managed by macOS launchd. Crashes or unexpected exits trigger an automatic restart after 5 seconds.
+* **👥 Operator Permissions & Read-Only Mode (v1.3.19):** Add `operator_ids` to restrict who can execute Claude commands in shared groups. Non-operators can still chat and query (read/search/web only) — they just can't edit files, run bash, or trigger slash commands. Use `/myid` to discover any user's Feishu open_id.
 
 ## 🛠 Prerequisites
 
@@ -341,6 +345,9 @@ Bot: 回退到哪一轮？
 | `/budget` | Today's token usage |
 | `/quiet` | Silence mirror/reflections for 48h |
 | `/reload` | Manually reload daemon.yaml (also auto-reloads on file change) |
+| `/bind <name>` | Register current group as a dedicated agent chat — opens directory browser to pick working directory |
+| `/chatid` | Show the current group's chat ID |
+| `/myid` | Show your own Feishu sender open_id (for configuring `operator_ids`) |
 
 **Heartbeat Tasks:**
 
@@ -395,10 +402,126 @@ Each step runs in the same Claude Code session. Step outputs automatically becom
 **Security:**
 
 * `allowed_chat_ids` whitelist — unauthorized users silently ignored (empty = deny all)
+* `operator_ids` — within an allowed group, restrict command execution to specific users; non-operators get read-only chat mode
 * `dangerously_skip_permissions` enabled by default for mobile (users can't click "allow" on phone — security relies on the chat ID whitelist)
 * `~/.metame/` directory set to mode 700
 * Bot tokens stored locally, never transmitted
 
+### Multi-Agent Projects — Context Isolation & Nickname Routing (v1.3.18)
+
+Organize your work into named agents, each tied to a project directory. Switch between them instantly from your phone — no commands needed, just say their name.
+
+**How it works:**
+
+Each `project` entry in `daemon.yaml` defines an agent with a working directory, display name, notification color, and optional nicknames. When you send a message starting with a nickname, the daemon instantly switches to that project's last session — no Claude call, no token cost.
+
+**Setup via conversation:**
+
+The easiest way to add an agent is to tell the bot:
+
+> *"Add a project called 'work' pointing to ~/my-project, nickname is '工作'"*
+
+Or edit `~/.metame/daemon.yaml` directly:
+
+```yaml
+projects:
+  my_agent:
+    name: "My Agent"          # Display name in notifications
+    icon: "🤖"               # Emoji shown in Feishu cards
+    color: "blue"            # Feishu card color: blue|orange|green|purple|red|grey
+    cwd: "~/my-project"      # Working directory for this agent
+    nicknames: [nickname1, nickname2]   # Wake words (matched at message start)
+    heartbeat_tasks: []      # Scheduled tasks for this project (optional)
+```
+
+**Available colors:** `blue` · `orange` · `green` · `purple` · `red` · `grey` · `turquoise`
+
+**Phone commands:**
+
+| Action | How |
+|--------|-----|
+| Switch agent | Send the nickname alone: `贾维斯` → `🤖 Jarvis 在线` |
+| Switch + ask | `贾维斯, what's the status?` → switches then asks Claude |
+| Pick from list | `/agent` → tap button to switch |
+| Continue a reply | Reply to any bot message → session auto-restored |
+| View all tasks | `/tasks` → grouped by project |
+| Run a task | `/run <task-name>` |
+
+**Nickname routing rules:**
+- Matched at **message start only** — mentioning a nickname mid-sentence never triggers a switch
+- Pure nickname (no content after) → instant switch, zero token cost, bypasses cooldown
+- Nickname + content → switch then send content to Claude
+
+**Heartbeat task notifications** arrive as colored Feishu cards — each project's color is distinct, so you can tell at a glance which agent sent the update.
+
+### Parallel Multi-Agent Chats & `/bind` Command (v1.3.19)
+
+Give each agent its own dedicated group chat — messages to different groups execute simultaneously without blocking each other.
+
+**How it works:**
+
+Each group is mapped to a specific agent via `chat_agent_map` in `daemon.yaml`. When a message arrives in a group, the daemon looks up which agent owns that `chatId` and dispatches the Claude call to that agent's working directory — fully parallel.
+
+**Setup — `/bind` command (recommended):**
+
+1. Create a new Feishu or Telegram group and add your bot.
+2. In the group, send `/bind <name>` (e.g., `/bind backend`).
+3. The bot opens a Finder-style directory browser — tap folders to navigate, tap a folder name to select it as the working directory.
+4. Done. The bot automatically:
+   - Adds the group's `chatId` to `allowed_chat_ids`
+   - Creates a `chat_agent_map` entry routing this group to the agent
+   - Creates a `projects` entry for the agent
+   - Sends a welcome card
+
+> **No whitelist required:** `/bind` works in any group — the new group self-registers without needing to be pre-approved in `allowed_chat_ids`.
+
+> **Re-binding:** Send `/bind <name>` again in the same group to overwrite the previous configuration.
+
+**Manual setup** (`~/.metame/daemon.yaml`):
+
+```yaml
+chat_agent_map:
+  "oc_abc123": "backend"          # chatId → project key
+  "oc_def456": "frontend"
+
+projects:
+  backend:
+    name: "Backend API"
+    cwd: "~/projects/api"
+  frontend:
+    name: "Frontend App"
+    cwd: "~/projects/app"
+```
+
+**`/chatid` command:**
+
+In any authorized group, send `/chatid` and the bot replies with the current group's `chatId`. Useful for manual configuration.
+
+| Command | Description |
+|---------|-------------|
+| `/bind <name>` | Register current group as a dedicated agent chat — opens directory browser to pick working directory |
+| `/chatid` | Show the current group's chat ID |
+| `/myid` | Show your own Feishu sender open_id |
+
+**Operator Permissions (`operator_ids`):**
+
+In shared groups (e.g., a group with a colleague or tester), you can restrict who can execute Claude commands. Non-operators get a read-only chat mode — they can ask questions and search, but can't edit files, run bash, or trigger slash commands.
+
+```yaml
+feishu:
+  operator_ids:
+    - "ou_abc123yourid"   # Only these users can execute commands
+```
+
+Use `/myid` in any Feishu group to get a user's open_id. Then add it to `operator_ids` to grant full access.
+
+| User type | Chat & query | Slash commands | Write / Edit / Bash |
+|-----------|:---:|:---:|:---:|
+| Operator | ✅ | ✅ | ✅ |
+| Non-operator | ✅ | ❌ | ❌ |
+
+> If `operator_ids` is empty, all whitelisted users have full access (default behavior).
+
 ### Provider Relay — Third-Party Model Support (v1.3.11)
 
 MetaMe supports any Anthropic-compatible API relay as a backend. This means you can route Claude Code through a third-party relay that maps `sonnet`/`opus`/`haiku` to any model (GPT-4, DeepSeek, Gemini, etc.) — MetaMe passes standard model names and the relay handles translation.
@@ -602,6 +725,8 @@ A: No. Your profile stays local at `~/.claude_profile.yaml`. MetaMe simply passe
 
 | Version | Highlights |
 |---------|------------|
+| **v1.3.19** | **Parallel multi-agent group chats** — `chat_agent_map` routes chatId → agent for true parallel execution; `/bind` command for one-tap group registration with Finder-style directory browser; `/chatid` to look up group ID; `allowed_chat_ids` hot-reload fix (read per message, no restart); `/fix` now merges current chatId config; daemon auto-restart via macOS LaunchAgent (5-second recovery); **operator_ids** permission layer — non-operators get read-only chat mode (query/search, no write/execute); `/myid` command to retrieve Feishu open_id |
+| **v1.3.18** | **Multi-agent project isolation** — `projects` in `daemon.yaml` with per-project heartbeat tasks, Feishu colored cards per project, `/agent` picker button, nickname routing (say agent name to switch instantly), reply-to-message session restoration, fix `~` expansion in project cwd |
 | **v1.3.17** | **Windows support** (WSL one-command installer), `install-systemd` for Linux/WSL daemon auto-start. Fix onboarding (Genesis interview was never injected, CLAUDE.md accumulated across runs). Marker-based cleanup, unified protocols, `--append-system-prompt` guarantees interview activation, Feishu auto-fetch chat ID, full mobile permissions, fix `/publish` false-success, auto-restart daemon on script update |
 | **v1.3.16** | Git-based `/undo` (auto-checkpoint before each turn, `git reset --hard` rollback), `/nosleep` toggle (macOS caffeinate), custom provider model passthrough (`/model` accepts any name for non-anthropic providers), auto-fallback to anthropic/opus on provider failure, message queue works on Telegram (fire-and-forget poll loop), lazy background distill |
 | **v1.3.15** | Native Playwright MCP (browser automation for all users), `/list` interactive file browser with buttons, Feishu image download fix, Skill/MCP/Agent status push, hot restart reliability (single notification, no double instance) |

package/index.js

@@ -28,9 +28,22 @@ if (!fs.existsSync(METAME_DIR)) {
 }
 
 // Auto-deploy bundled scripts to ~/.metame/
+// IMPORTANT: daemon.yaml is USER CONFIG — never overwrite it. Only daemon-default.yaml (template) is synced.
 const BUNDLED_SCRIPTS = ['signal-capture.js', 'distill.js', 'schema.js', 'pending-traits.js', 'migrate-v2.js', 'daemon.js', 'telegram-adapter.js', 'feishu-adapter.js', 'daemon-default.yaml', 'providers.js', 'session-analytics.js', 'resolve-yaml.js', 'utils.js'];
 const scriptsDir = path.join(__dirname, 'scripts');
 
+// Protect daemon.yaml: create backup before any sync operation
+const DAEMON_YAML_BACKUP = path.join(METAME_DIR, 'daemon.yaml.bak');
+try {
+  if (fs.existsSync(DAEMON_CONFIG_FILE)) {
+    const content = fs.readFileSync(DAEMON_CONFIG_FILE, 'utf8');
+    // Only backup if it has real config (not just the default template)
+    if (content.includes('enabled: true') || content.includes('bot_token:') && !content.includes('bot_token: null')) {
+      fs.copyFileSync(DAEMON_CONFIG_FILE, DAEMON_YAML_BACKUP);
+    }
+  }
+} catch { /* non-fatal */ }
+
 let scriptsUpdated = false;
 for (const script of BUNDLED_SCRIPTS) {
   const src = path.join(scriptsDir, script);
@@ -63,7 +76,11 @@ if (scriptsUpdated) {
       }, 2000);
       const DAEMON_SCRIPT = path.join(METAME_DIR, 'daemon.js');
       setTimeout(() => {
-        const bg = spawn(process.execPath, [DAEMON_SCRIPT], {
+        // Use caffeinate on macOS to prevent sleep while daemon is running
+        const isNotWindows = process.platform !== 'win32';
+        const cmd = isNotWindows ? 'caffeinate' : process.execPath;
+        const args = isNotWindows ? ['-i', process.execPath, DAEMON_SCRIPT] : [DAEMON_SCRIPT];
+        const bg = spawn(cmd, args, {
           detached: true,
           stdio: 'ignore',
           env: { ...process.env, HOME: HOME_DIR, METAME_ROOT: __dirname },
@@ -77,11 +94,27 @@ if (scriptsUpdated) {
   }
 }
 
-// Ensure daemon.yaml exists (copy from template if missing)
+// Load daemon config for local launch flags
+let daemonCfg = {};
+try {
+  if (fs.existsSync(DAEMON_CONFIG_FILE)) {
+    const _yaml = require(path.join(__dirname, 'node_modules', 'js-yaml'));
+    const raw = _yaml.load(fs.readFileSync(DAEMON_CONFIG_FILE, 'utf8')) || {};
+    daemonCfg = raw.daemon || {};
+  }
+} catch { /* non-fatal */ }
+
+// Ensure daemon.yaml exists (restore backup or copy from template)
 if (!fs.existsSync(DAEMON_CONFIG_FILE)) {
-  const daemonTemplate = path.join(scriptsDir, 'daemon-default.yaml');
-  if (fs.existsSync(daemonTemplate)) {
-    fs.copyFileSync(daemonTemplate, DAEMON_CONFIG_FILE);
+  if (fs.existsSync(DAEMON_YAML_BACKUP)) {
+    // Restore from backup — user had real config that was lost
+    fs.copyFileSync(DAEMON_YAML_BACKUP, DAEMON_CONFIG_FILE);
+    console.log('⚠️  daemon.yaml was missing — restored from backup.');
+  } else {
+    const daemonTemplate = path.join(scriptsDir, 'daemon-default.yaml');
+    if (fs.existsSync(daemonTemplate)) {
+      fs.copyFileSync(daemonTemplate, DAEMON_CONFIG_FILE);
+    }
   }
 }
 
@@ -161,6 +194,30 @@ function spawnDistillBackground() {
   const distillPath = path.join(METAME_DIR, 'distill.js');
   if (!fs.existsSync(distillPath)) return;
 
+  // Early exit if distillation already in progress (prevents duplicate spawns across terminals)
+  const lockFile = path.join(METAME_DIR, 'distill.lock');
+  if (fs.existsSync(lockFile)) {
+    try {
+      const lockAge = Date.now() - fs.statSync(lockFile).mtimeMs;
+      if (lockAge < 120000) return;
+    } catch { /* stale lock, proceed */ }
+  }
+
+  // 4-hour cooldown: check last distill timestamp from profile
+  const cooldownMs = 4 * 60 * 60 * 1000;
+  try {
+    const profilePath = path.join(process.env.HOME || '', '.claude_profile.yaml');
+    if (fs.existsSync(profilePath)) {
+      const yaml = require('js-yaml');
+      const profile = yaml.load(fs.readFileSync(profilePath, 'utf8'));
+      const distillLog = profile && profile.evolution && profile.evolution.auto_distill;
+      if (Array.isArray(distillLog) && distillLog.length > 0) {
+        const lastTs = new Date(distillLog[distillLog.length - 1].ts).getTime();
+        if (Date.now() - lastTs < cooldownMs) return;
+      }
+    }
+  } catch { /* non-fatal, proceed */ }
+
   const hasSignals = shouldDistill();
   const bootstrap = needsBootstrap();
 
@@ -263,7 +320,7 @@ runExpiryCleanup();
 if (!fs.existsSync(BRAIN_FILE)) {
   const initialProfile = `identity:
   role: Unknown
-  nickname: null
+  locale: null
 status:
   focus: Initializing
 `;
@@ -325,12 +382,12 @@ You are entering **Calibration Mode**. You are not a chatbot; you are a Psycholo
 
 5. **Shadows (Hidden Fears):** What are you avoiding? What pattern do you keep repeating? What keeps you up at night?
 
-6. **Identity (Nickname + Role):** Based on everything learned, propose a nickname and role summary. Ask if it resonates.
+6. **Identity (Role + Locale):** Based on everything learned, propose a role summary and confirm their preferred language (locale). Ask if it resonates.
 
 **TERMINATION:**
 - After 5-7 exchanges, synthesize everything into \`~/.claude_profile.yaml\`.
 - **LOCK** Core Values with \`# [LOCKED]\`.
-- Announce: "Link Established. I see you now, [Nickname]."
+- Announce: "Link Established. Profile calibrated."
 - Then proceed to **Phase 2** below.
 
 **3. SETUP WIZARD (Phase 2 — Optional):**
@@ -398,7 +455,7 @@ let isKnownUser = false;
 try {
   if (fs.existsSync(BRAIN_FILE)) {
     const doc = yaml.load(fs.readFileSync(BRAIN_FILE, 'utf8')) || {};
-    if (doc.identity && doc.identity.nickname && doc.identity.nickname !== 'null') {
+    if (doc.identity && doc.identity.locale && doc.identity.locale !== 'null') {
       isKnownUser = true;
     }
   }
@@ -1086,6 +1143,8 @@ if (isDaemon) {
   <string>com.metame.daemon</string>
   <key>ProgramArguments</key>
   <array>
+    <string>/usr/bin/caffeinate</string>
+    <string>-i</string>
     <string>${nodePath}</string>
     <string>${DAEMON_SCRIPT}</string>
   </array>
@@ -1207,7 +1266,11 @@ WantedBy=default.target
       console.error("❌ daemon.js not found. Reinstall MetaMe.");
       process.exit(1);
     }
-    const bg = spawn(process.execPath, [DAEMON_SCRIPT], {
+    // Use caffeinate on macOS/Linux to prevent sleep while daemon is running
+    const isNotWindows = process.platform !== 'win32';
+    const cmd = isNotWindows ? 'caffeinate' : process.execPath;
+    const args = isNotWindows ? ['-i', process.execPath, DAEMON_SCRIPT] : [DAEMON_SCRIPT];
+    const bg = spawn(cmd, args, {
       detached: true,
       stdio: 'ignore',
       env: { ...process.env, HOME: HOME_DIR, METAME_ROOT: __dirname },
@@ -1363,7 +1426,9 @@ if (isSync) {
 
   console.log(`\n🔄 Resuming session ${bestSession.id.slice(0, 8)}...\n`);
   const providerEnv = (() => { try { return require(path.join(__dirname, 'scripts', 'providers.js')).buildActiveEnv(); } catch { return {}; } })();
-  const syncChild = spawn('claude', ['--resume', bestSession.id], {
+  const resumeArgs = ['--resume', bestSession.id];
+  if (daemonCfg.dangerously_skip_permissions) resumeArgs.push('--dangerously-skip-permissions');
+  const syncChild = spawn('claude', resumeArgs, {
     stdio: 'inherit',
     env: { ...process.env, ...providerEnv, METAME_ACTIVE_SESSION: 'true' }
   });
@@ -1398,6 +1463,9 @@ if (activeProviderName !== 'anthropic') {
 
 // Build launch args — inject system prompt for new users
 const launchArgs = process.argv.slice(2);
+if (daemonCfg.dangerously_skip_permissions && !launchArgs.includes('--dangerously-skip-permissions')) {
+  launchArgs.push('--dangerously-skip-permissions');
+}
 if (!isKnownUser) {
   launchArgs.push(
     '--append-system-prompt',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "metame-cli",
-    "version": "1.3.17",
+    "version": "1.3.20",
     "description": "The Cognitive Profile Layer for Claude Code. Knows how you think, not just what you said.",
     "main": "index.js",
     "bin": {

package/scripts/daemon-default.yaml

@@ -12,8 +12,27 @@ feishu:
   app_secret: null
   allowed_chat_ids: []
 
+projects:
+  # Per-project heartbeat tasks. Each project's tasks are isolated and
+  # notifications arrive as colored Feishu cards (visually distinct).
+  #
+  # example_project:
+  #   name: "My Project"
+  #   icon: "🎬"
+  #   color: "orange"        # blue|orange|green|red|grey|purple|turquoise
+  #   heartbeat_tasks:
+  #     - name: "daily-task"
+  #       cwd: "~/AGI/MyProject"
+  #       model: "sonnet"
+  #       interval: "24h"
+  #       notify: true
+  #       enabled: true
+  #       prompt: "..."
+  #       allowedTools: [Read, Write, WebSearch]
+
 heartbeat:
   tasks: []
+    # Legacy flat tasks (no project isolation). New tasks should go under projects: above.
     # Examples — uncomment or add your own:
     #
     # Scheduled task (calls claude -p with your profile context):