metame-cli 1.4.31 → 1.4.33

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "metame-cli",
-    "version": "1.4.31",
+    "version": "1.4.33",
     "description": "The Cognitive Profile Layer for Claude Code. Knows how you think, not just what you said.",
     "main": "index.js",
     "bin": {
@@ -13,7 +13,8 @@
     "scripts": {
         "test": "node --test scripts/*.test.js",
         "start": "node index.js",
-        "sync:plugin": "cp scripts/schema.js scripts/pending-traits.js scripts/signal-capture.js scripts/distill.js scripts/daemon.js scripts/daemon-agent-commands.js scripts/daemon-session-commands.js scripts/daemon-admin-commands.js scripts/daemon-exec-commands.js scripts/daemon-ops-commands.js scripts/daemon-session-store.js scripts/daemon-checkpoints.js scripts/daemon-bridges.js scripts/daemon-file-browser.js scripts/daemon-runtime-lifecycle.js scripts/daemon-notify.js scripts/daemon-claude-engine.js scripts/daemon-command-router.js scripts/daemon-user-acl.js scripts/daemon-agent-tools.js scripts/daemon-task-scheduler.js scripts/daemon-task-envelope.js scripts/task-board.js scripts/telegram-adapter.js scripts/feishu-adapter.js scripts/daemon-default.yaml scripts/providers.js scripts/utils.js scripts/usage-classifier.js scripts/resolve-yaml.js scripts/memory.js scripts/memory-extract.js scripts/qmd-client.js scripts/session-summarize.js scripts/session-analytics.js scripts/skill-evolution.js scripts/check-macos-control-capabilities.sh plugin/scripts/ && echo '✅ Plugin scripts synced'",
+        "sync:plugin": "cp scripts/platform.js scripts/schema.js scripts/pending-traits.js scripts/signal-capture.js scripts/distill.js scripts/daemon.js scripts/daemon-agent-commands.js scripts/daemon-session-commands.js scripts/daemon-admin-commands.js scripts/daemon-exec-commands.js scripts/daemon-ops-commands.js scripts/daemon-session-store.js scripts/daemon-checkpoints.js scripts/daemon-bridges.js scripts/daemon-file-browser.js scripts/daemon-runtime-lifecycle.js scripts/daemon-notify.js scripts/daemon-claude-engine.js scripts/daemon-command-router.js scripts/daemon-user-acl.js scripts/daemon-agent-tools.js scripts/daemon-task-scheduler.js scripts/daemon-task-envelope.js scripts/task-board.js scripts/telegram-adapter.js scripts/feishu-adapter.js scripts/daemon-default.yaml scripts/providers.js scripts/utils.js scripts/usage-classifier.js scripts/resolve-yaml.js scripts/memory.js scripts/memory-extract.js scripts/qmd-client.js scripts/session-summarize.js scripts/session-analytics.js scripts/skill-evolution.js scripts/check-macos-control-capabilities.sh plugin/scripts/ && echo '✅ Plugin scripts synced'",
+        "sync:readme": "node scripts/sync-readme.js",
         "restart:daemon": "node index.js stop 2>/dev/null; sleep 1; node index.js start 2>/dev/null || echo '⚠️  Daemon not running or restart failed'",
         "precommit": "npm run sync:plugin && npm run restart:daemon"
     },

package/scripts/bin/dispatch_to

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+/**
+ * dispatch_to [--new] <project_key> "<prompt>"
+ * Tries Unix socket / Named Pipe first (low-latency), falls back to pending.jsonl.
+ */
+'use strict';
+const fs = require('fs');
+const path = require('path');
+const net = require('net');
+const crypto = require('crypto');
+const os = require('os');
+const { socketPath } = require('../platform');
+
+const args = process.argv.slice(2);
+const newSession = args[0] === '--new' ? (args.shift(), true) : false;
+const [target, ...rest] = args;
+const prompt = rest.join(' ').replace(/^["']|["']$/g, '');
+if (!target || !prompt) {
+  console.error('Usage: dispatch_to [--new] <project_key> "<prompt>"');
+  process.exit(1);
+}
+
+const METAME_DIR = path.join(os.homedir(), '.metame');
+const DISPATCH_DIR = path.join(METAME_DIR, 'dispatch');
+const PENDING = path.join(DISPATCH_DIR, 'pending.jsonl');
+const DISPATCH_SECRET_FILE = path.join(METAME_DIR, '.dispatch_secret');
+const SOCK_PATH = socketPath(METAME_DIR);
+
+function getDispatchSecret() {
+  try {
+    if (fs.existsSync(DISPATCH_SECRET_FILE)) {
+      return fs.readFileSync(DISPATCH_SECRET_FILE, 'utf8').trim();
+    }
+  } catch { /* fall through to generate */ }
+  const secret = crypto.randomBytes(32).toString('hex');
+  try {
+    fs.writeFileSync(DISPATCH_SECRET_FILE, secret, { mode: 0o600 });
+  } catch { /* ignore write errors */ }
+  return secret;
+}
+
+const ts = new Date().toISOString();
+const secret = getDispatchSecret();
+const sigPayload = JSON.stringify({ target, prompt, ts });
+const sig = crypto.createHmac('sha256', secret).update(sigPayload).digest('hex');
+
+const msg = { target, prompt, from: '_claude_session', new_session: newSession, created_at: ts, ts, sig };
+
+function fallbackToFile() {
+  fs.mkdirSync(DISPATCH_DIR, { recursive: true });
+  fs.appendFileSync(PENDING, JSON.stringify(msg) + '\n');
+  console.log(`DISPATCH_OK(file): ${target} → ${prompt.slice(0, 60)}${newSession ? ' [new session]' : ''}`);
+}
+
+const sock = net.createConnection({ path: SOCK_PATH });
+let done = false;
+
+const timer = setTimeout(() => {
+  if (done) return;
+  done = true;
+  sock.destroy();
+  fallbackToFile();
+}, 2000);
+
+sock.on('connect', () => {
+  sock.write(JSON.stringify(msg));
+  sock.end();
+});
+
+sock.on('data', (data) => {
+  if (done) return;
+  done = true;
+  clearTimeout(timer);
+  try {
+    const res = JSON.parse(data.toString().trim());
+    if (res.ok) {
+      console.log(`DISPATCH_OK(socket): ${target} → ${prompt.slice(0, 60)}${newSession ? ' [new session]' : ''}`);
+    } else {
+      fallbackToFile();
+    }
+  } catch {
+    fallbackToFile();
+  }
+  sock.destroy();
+});
+
+sock.on('error', () => {
+  if (done) return;
+  done = true;
+  clearTimeout(timer);
+  fallbackToFile();
+});

package/scripts/daemon-claude-engine.js

@@ -633,7 +633,10 @@ Reply with ONLY the name, nothing else. Examples: 插件开发, API重构, Bug
     }, 4000);
 
     // Agent nickname routing: "贾维斯" / "小美，帮我..." → switch project session
-    const agentMatch = routeAgent(prompt, config);
+    // Strict chats (chat_agent_map bound groups) must NOT switch agents via nickname
+    const _strictAgentMap = { ...(config.telegram ? config.telegram.chat_agent_map : {}), ...(config.feishu ? config.feishu.chat_agent_map : {}) };
+    const _isStrictChatSession = !!(_strictAgentMap[String(chatId)] || projectKeyFromVirtualChatId(String(chatId)));
+    const agentMatch = _isStrictChatSession ? null : routeAgent(prompt, config);
     if (agentMatch) {
       const { key, proj, rest } = agentMatch;
       const projCwd = normalizeCwd(proj.cwd);
@@ -835,7 +838,7 @@ Reply with ONLY the name, nothing else. Examples: 插件开发, API重构, Bug
    Use these before answering complex questions about MetaMe architecture or past decisions.
 4. Active memory: After confirming a new insight, bug root cause, or user preference, persist it with:
    node ~/.metame/memory-write.js "Entity.sub" "relation_type" "value (20-300 chars)"
-   Valid relations: tech_decision, bug_lesson, arch_convention, config_fact, config_change, user_pref, workflow_rule, project_milestone
+   Valid relations: tech_decision, bug_lesson, arch_convention, config_fact, config_change, workflow_rule, project_milestone
    Only write verified facts. Do not write speculative or process-description entries.
    When you observe the user is clearly expert or beginner in a domain, note it in your response and suggest: "要不要把你的 {domain} 水平 ({level}) 记录到能力雷达？"
 5. Task handoff: When suspending a multi-step task or handing off to another agent, write current status to ~/.metame/memory/NOW.md using:

package/scripts/daemon-runtime-lifecycle.js

@@ -1,7 +1,9 @@
 'use strict';
 
+const { sleepSync } = require('./platform');
+
 function createPidManager(deps) {
-  const { fs, execSync, PID_FILE, log } = deps;
+  const { fs, PID_FILE, log } = deps;
 
   function killExistingDaemon() {
     if (!fs.existsSync(PID_FILE)) return;
@@ -12,7 +14,7 @@ function createPidManager(deps) {
         log('INFO', `Killed existing daemon (PID: ${oldPid})`);
         for (let i = 0; i < 10; i++) {
           try { process.kill(oldPid, 0); } catch { break; }
-          execSync('sleep 0.5', { stdio: 'ignore' });
+          sleepSync(500);
         }
       }
     } catch {

package/scripts/daemon-task-scheduler.js

@@ -2,6 +2,7 @@
 
 const crypto = require('crypto');
 const { classifyTaskUsage } = require('./usage-classifier');
+const { IS_WIN } = require('./platform');
 
 const WEEKDAY_INDEX = Object.freeze({
   sun: 0,
@@ -192,7 +193,30 @@ function createTaskScheduler(deps) {
     if (!task.precondition) return { pass: true, context: '' };
 
     try {
-      const output = execSync(task.precondition, {
+      let cmd = task.precondition;
+
+      // Cross-platform: expand ~ to HOME and handle `test -s` (Unix-only) via Node.js
+      cmd = cmd.replace(/^~|(?<=\s)~/g, HOME);
+      if (IS_WIN) {
+        // `test -s <file>` checks file exists and is non-empty — do it in JS
+        const testMatch = cmd.match(/^test\s+-s\s+(.+)$/);
+        if (testMatch) {
+          const filePath = testMatch[1].trim().replace(/["']/g, '');
+          const fs = require('fs');
+          try {
+            const stat = fs.statSync(filePath);
+            if (stat.size > 0) {
+              const content = fs.readFileSync(filePath, 'utf8').trim();
+              log('INFO', `Precondition passed for ${task.name} (${content.split('\n').length} lines)`);
+              return { pass: true, context: content };
+            }
+          } catch { /* file doesn't exist */ }
+          log('INFO', `Precondition failed for ${task.name}: file empty or missing`);
+          return { pass: false, context: '' };
+        }
+      }
+
+      const output = execSync(cmd, {
         encoding: 'utf8',
         timeout: 15000,
         maxBuffer: 64 * 1024,
@@ -296,7 +320,8 @@ function createTaskScheduler(deps) {
 
     // Script tasks: run a local script directly (e.g. distill.js), no claude -p
     if (task.type === 'script') {
-      log('INFO', `Executing script task: ${task.name} → ${task.command}`);
+      const scriptCmd = task.command.replace(/^~|(?<=\s)~/g, HOME);
+      log('INFO', `Executing script task: ${task.name} → ${scriptCmd}`);
       try {
         const scriptEnv = {
           ...process.env,
@@ -304,7 +329,7 @@ function createTaskScheduler(deps) {
           METAME_INTERNAL_PROMPT: '1',
         };
         delete scriptEnv.CLAUDECODE;
-        const output = execSync(task.command, {
+        const output = execSync(scriptCmd, {
           encoding: 'utf8',
           timeout: resolveTimeoutMs(task.timeout, 120),
           maxBuffer: 1024 * 1024,

package/scripts/daemon.js

@@ -16,6 +16,22 @@
 // Suppress Node.js experimental warnings (e.g. SQLite)
 process.removeAllListeners('warning');
 
+// Global error handlers — prevent silent event-loop death
+process.on('unhandledRejection', (reason) => {
+  try {
+    const msg = reason instanceof Error ? reason.stack || reason.message : String(reason);
+    const line = `[${new Date().toISOString()}] [ERROR] [UNHANDLED_REJECTION] ${msg}\n`;
+    fs.appendFileSync(path.join(os.homedir(), '.metame', 'daemon.log'), line);
+  } catch { /* last resort: don't crash the crash handler */ }
+});
+process.on('uncaughtException', (err) => {
+  try {
+    const line = `[${new Date().toISOString()}] [FATAL] [UNCAUGHT_EXCEPTION] ${err.stack || err.message}\n`;
+    fs.appendFileSync(path.join(os.homedir(), '.metame', 'daemon.log'), line);
+  } catch { /* last resort */ }
+  // Don't exit — let the daemon survive and self-heal via watchdog
+});
+
 const fs = require('fs');
 const path = require('path');
 const os = require('os');
@@ -30,7 +46,8 @@ const LOG_FILE = path.join(METAME_DIR, 'daemon.log');
 const BRAIN_FILE = path.join(HOME, '.claude_profile.yaml');
 const DISPATCH_DIR = path.join(METAME_DIR, 'dispatch');
 const DISPATCH_LOG = path.join(DISPATCH_DIR, 'dispatch-log.jsonl');
-const SOCK_PATH = path.join(METAME_DIR, 'daemon.sock');
+const { socketPath, needsSocketCleanup } = require('./platform');
+const SOCK_PATH = socketPath(METAME_DIR);
 
 // Resolve claude binary path (daemon may not inherit user's full PATH)
 const CLAUDE_BIN = (() => {
@@ -975,7 +992,7 @@ function handleDispatchItem(item, config) {
  */
 function startDispatchSocket(getConfig) {
   const net = require('net');
-  try { fs.unlinkSync(SOCK_PATH); } catch { /* ok */ }
+  if (needsSocketCleanup()) { try { fs.unlinkSync(SOCK_PATH); } catch { /* ok */ } }
   const server = net.createServer((conn) => {
     let buf = '';
     conn.on('data', d => { buf += d; });
@@ -1611,7 +1628,6 @@ const { startTelegramBridge, startFeishuBridge } = createBridgeStarter({
 
 const { killExistingDaemon, writePid, cleanPid } = createPidManager({
   fs,
-  execSync,
   PID_FILE,
   log,
 });
@@ -1820,6 +1836,27 @@ async function main() {
   process.on('SIGTERM', () => { shutdown().catch(() => process.exit(0)); });
   process.on('SIGINT', () => { shutdown().catch(() => process.exit(0)); });
 
+  // Watchdog: detect heartbeat stall and self-restart
+  const WATCHDOG_INTERVAL = 5 * 60 * 1000; // check every 5 min
+  const HEARTBEAT_STALL_THRESHOLD = 5 * 60 * 1000; // 5 min without heartbeat = stalled
+  setInterval(() => {
+    try {
+      const st = loadState();
+      const lastAlive = st.last_alive ? new Date(st.last_alive).getTime() : 0;
+      const elapsed = Date.now() - lastAlive;
+      if (lastAlive > 0 && elapsed > HEARTBEAT_STALL_THRESHOLD) {
+        log('FATAL', `[WATCHDOG] Heartbeat stalled for ${Math.round(elapsed / 1000)}s — forcing restart`);
+        // Write state before exit so next launch knows why
+        st.watchdog_restart = new Date().toISOString();
+        st.watchdog_stall_seconds = Math.round(elapsed / 1000);
+        saveState(st);
+        process.exit(1); // caffeinate or launchd will restart us
+      }
+    } catch (e) {
+      log('WARN', `[WATCHDOG] Check failed: ${e.message}`);
+    }
+  }, WATCHDOG_INTERVAL).unref();
+
   // Keep alive
   log('INFO', 'Daemon running. Send SIGTERM to stop.');
 }

package/scripts/docs/agent-guide.md

@@ -0,0 +1,50 @@
+# Agent 创建与管理指南
+
+## 创建 Agent（完整流程）
+
+用户说"创建agent"、"新建agent"、"帮我建个agent"时，按此流程引导：
+
+### Step 1: 收集信息
+需要两个必要信息：
+- **工作目录**：Agent 的代码/项目目录（如 `~/projects/my-bot`）
+- **角色描述**（可选）：Agent 的职责定义
+
+如果用户没给目录，提示：
+> 请告诉我 Agent 的工作目录，例如 `~/projects/my-bot`
+
+### Step 2: 执行创建
+在手机端（飞书/Telegram），直接说即可，daemon 会自动处理：
+> 创建一个 Agent，目录是 ~/projects/my-bot
+
+在桌面 Claude Code 终端，需要手动操作：
+1. 创建项目目录和 CLAUDE.md（角色定义）
+2. 编辑 `~/.metame/daemon.yaml`，在 `projects` 下新增：
+   ```yaml
+   projects:
+     my_bot:
+       name: "我的机器人"
+       cwd: "~/projects/my-bot"
+       icon: "🤖"
+   ```
+3. 运行 `touch ~/.metame/daemon.js` 触发热重载
+
+### Step 3: 绑定群聊
+告知用户：
+> 请在飞书/Telegram 新建群组，把 bot 加进去，发送 `/activate` 完成绑定。
+
+`/activate` 会自动将群与最近创建的 Agent 绑定（30分钟内有效）。
+
+## 常用命令速查
+
+| 操作 | 手机端命令 |
+|------|-----------|
+| 新建 Agent | `/agent new` 或自然语言"创建agent" |
+| 绑定群 | `/activate` 或 `/agent bind <名称> [目录]` |
+| 查看列表 | `/agent list` |
+| 编辑角色 | `/agent edit` |
+| 解绑群 | `/agent unbind` |
+| 切换 Agent | 直接@昵称（仅非专属群） |
+
+## 注意事项
+- 专属群（chat_agent_map 中的群）永远绑定同一个 Agent，不能通过昵称切换
+- 新群必须发 `/activate` 才能使用，未授权群会提示"此群未授权"

package/scripts/docs/file-transfer.md

@@ -0,0 +1,32 @@
+# 文件传输协议
+
+## 用户要文件（发送到手机）
+
+当用户说"把xx发给我"、"文件发过来"、"发个截图"、"导出给我"等**任何要求获取文件**的场景：
+
+1. 找到文件路径（用 Glob/ls 搜索）
+2. **不要读取文件内容**（浪费 token）
+3. 在回复末尾加标记：`[[FILE:/absolute/path/to/file]]`
+4. 多个文件用多个标记
+
+示例回复：
+```
+请查收~! [[FILE:/Users/xxx/project/output.pdf]]
+```
+
+多文件：
+```
+这是你要的文件：
+[[FILE:/path/to/report.pdf]]
+[[FILE:/path/to/data.xlsx]]
+```
+
+## 用户发文件（从手机上传）
+
+用户从手机发送的图片/文件会自动保存到当前项目的 `upload/` 目录。
+直接用 Read 工具读取 `upload/` 下的文件即可。
+
+## 关键规则
+- **永远不要读取再复述文件内容**，直接用 `[[FILE:...]]` 标记发送
+- 路径必须是绝对路径
+- daemon 会自动解析标记并通过 bot 发送给用户

package/scripts/feishu-adapter.js

@@ -401,7 +401,9 @@ function createBot(config) {
 
               if (text || fileInfo) {
                 // Fire-and-forget: don't block the event loop (SDK needs fast ack)
-                Promise.resolve().then(() => onMessage(chatId, text, data, fileInfo, senderId)).catch(() => {});
+                Promise.resolve().then(() => onMessage(chatId, text, data, fileInfo, senderId)).catch((err) => {
+                  try { console.error(`[feishu-adapter] onMessage error: ${err && err.message || err}`); } catch { }
+                });
               }
             } catch (e) {
               // Non-fatal
@@ -417,7 +419,9 @@ function createBot(config) {
               if (action && chatId) {
                 const cmd = action.value && action.value.cmd;
                 if (cmd) {
-                  Promise.resolve().then(() => onMessage(chatId, cmd, data)).catch(() => {});
+                  Promise.resolve().then(() => onMessage(chatId, cmd, data)).catch((err) => {
+                  try { console.error(`[feishu-adapter] card action error: ${err && err.message || err}`); } catch { }
+                });
                 }
               }
             } catch (e) {

package/scripts/memory-extract.js

@@ -29,8 +29,7 @@ const FACT_EXTRACTION_PROMPT = `你是精准的知识提取引擎。从以下会
 - arch_convention（架构约定：系统组件的行为边界）
 - config_fact（配置事实：某个值的真实含义，尤其反直觉的）
 - config_change（配置变更：用户选择/确认了某个具体配置值，如”字体选了x-large”、”间隔改为2h”）
-- user_pref（用户明确表达的偏好/红线）
-- workflow_rule（工作流戒律：如”不要在某情况下做某事”的反常识流）
+- workflow_rule（工作流戒律/用户红线：如”不要在某情况下做某事”的反常识流、用户明确表达的项目级红线）
 - project_milestone（项目里程碑：主要架构重构、版本发布等跨会话级成果）
 
 绝对不提取：
@@ -38,6 +37,7 @@ const FACT_EXTRACTION_PROMPT = `你是精准的知识提取引擎。从以下会
 - 临时状态（"当前正在..."、"这次会话..."）
 - 未经验证的猜测（"可能是因为..."、"也许..."）
 - 显而易见的常识
+- 泛化偏好（沟通风格、代码风格、语言偏好等）——这些由认知Profile自动采集，memory不重复记录
 
 输出 JSON 对象，包含会话名称和提取的事实：
 {

package/scripts/memory-gc.js

@@ -11,7 +11,7 @@
  *   2. search_count < 3
  *   3. superseded_by IS NULL          (already-superseded facts excluded)
  *   4. conflict_status IS NULL OR conflict_status = 'OK'  (skip CONFLICT/ARCHIVED)
- *   5. relation NOT IN protected set  (user_pref, workflow_rule, arch_convention never archived)
+ *   5. relation NOT IN protected set  (workflow_rule, arch_convention, config_fact never archived)
  *
  * Protected relations are permanently excluded — they are high-value guardrails
  * that must survive regardless of search frequency.
@@ -32,7 +32,7 @@ const LOCK_FILE = path.join(METAME_DIR, 'memory-gc.lock');
 const GC_LOG_FILE = path.join(METAME_DIR, 'memory_gc_log.jsonl');
 
 // Relations that are permanently protected from archival
-const PROTECTED_RELATIONS = ['user_pref', 'workflow_rule', 'arch_convention', 'config_fact'];
+const PROTECTED_RELATIONS = ['workflow_rule', 'arch_convention', 'config_fact'];
 
 // GC threshold: facts older than this many days are candidates
 const STALE_DAYS = 30;

package/scripts/memory-write.js

@@ -22,7 +22,6 @@ const VALID_RELATIONS = new Set([
   'arch_convention',
   'config_fact',
   'config_change',
-  'user_pref',
   'workflow_rule',
   'project_milestone',
 ]);

package/scripts/memory.js

@@ -226,7 +226,7 @@ function saveSession({ sessionId, project, scope = null, summary, keywords = '',
 
 // Relations with "current state" semantics: new value replaces old.
 // Historical relations (tech_decision, bug_lesson, arch_convention, project_milestone) keep all versions.
-const STATEFUL_RELATIONS = new Set(['user_pref', 'config_fact', 'config_change', 'workflow_rule']);
+const STATEFUL_RELATIONS = new Set(['config_fact', 'config_change', 'workflow_rule']);
 
 /**
  * Save atomic facts extracted from a session.

package/scripts/platform.js

@@ -0,0 +1,172 @@
+'use strict';
+
+const os = require('os');
+const path = require('path');
+const { execSync } = require('child_process');
+
+const IS_WIN = process.platform === 'win32';
+const IS_MAC = process.platform === 'darwin';
+const IS_LINUX = process.platform === 'linux';
+
+const HOME = os.homedir();
+
+/**
+ * IPC socket path: Named Pipe on Windows, Unix Domain Socket elsewhere.
+ */
+function socketPath(metameDir) {
+  if (IS_WIN) return `\\\\.\\pipe\\metame-daemon-${os.userInfo().username}`;
+  return path.join(metameDir, 'daemon.sock');
+}
+
+/**
+ * Cross-platform synchronous sleep.
+ * On Windows, sleep command doesn't exist; use a busy-wait with Atomics for short durations.
+ */
+function sleepSync(ms) {
+  if (IS_WIN) {
+    // Atomics.wait on a SharedArrayBuffer — blocks the thread without shell dependency
+    const buf = new SharedArrayBuffer(4);
+    const arr = new Int32Array(buf);
+    Atomics.wait(arr, 0, 0, ms);
+  } else {
+    const seconds = ms / 1000;
+    execSync(`sleep ${seconds}`, { stdio: 'ignore' });
+  }
+}
+
+/**
+ * Find PIDs matching a command-line pattern.
+ * Returns array of PID numbers (excluding current process).
+ */
+function findProcessesByPattern(pattern) {
+  const pids = [];
+  // Sanitize pattern to prevent command injection
+  const safe = pattern.replace(/['"%;$`\\]/g, '');
+  try {
+    let output;
+    if (IS_WIN) {
+      // wmic is deprecated but widely available; fallback to tasklist
+      try {
+        output = execSync(
+          `wmic process where "CommandLine like '%${safe}%'" get ProcessId /FORMAT:LIST`,
+          { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }
+        );
+        const matches = output.match(/ProcessId=(\d+)/g) || [];
+        for (const m of matches) {
+          const pid = parseInt(m.split('=')[1], 10);
+          if (pid && pid !== process.pid) pids.push(pid);
+        }
+      } catch {
+        // wmic not available, try PowerShell
+        output = execSync(
+          `powershell -NoProfile -Command "Get-CimInstance Win32_Process | Where-Object { $_.CommandLine -like '*${safe}*' } | Select-Object -ExpandProperty ProcessId"`,
+          { encoding: 'utf8', stdio: ['pipe', 'pipe', 'ignore'] }
+        );
+        for (const line of output.trim().split('\n')) {
+          const pid = parseInt(line.trim(), 10);
+          if (pid && pid !== process.pid) pids.push(pid);
+        }
+      }
+    } else {
+      output = execSync(`pgrep -f '${safe}' 2>/dev/null || true`, { encoding: 'utf8' });
+      for (const line of output.trim().split('\n')) {
+        const pid = parseInt(line.trim(), 10);
+        if (pid && pid !== process.pid) pids.push(pid);
+      }
+    }
+  } catch { /* ignore errors */ }
+  return pids;
+}
+
+/**
+ * Whether the socket path needs fs.unlinkSync before server.listen().
+ * Named Pipes on Windows are kernel-managed — no file to unlink.
+ */
+function needsSocketCleanup() {
+  return !IS_WIN;
+}
+
+/**
+ * GBK-safe icon mapping for Windows terminals.
+ * Chinese Windows terminals use GBK encoding by default,
+ * which cannot render emoji — replace with ASCII equivalents.
+ */
+const _icons = IS_WIN ? {
+  // status
+  ok:       '[OK]',
+  fail:     '[FAIL]',
+  warn:     '[!]',
+  info:     '[i]',
+  // objects
+  pkg:      '[PKG]',
+  brain:    '[*]',
+  dna:      '[~]',
+  new:      '[NEW]',
+  magic:    '[>]',
+  bot:      '[BOT]',
+  green:    '[ON]',
+  red:      '[OFF]',
+  hook:     '[HOOK]',
+  search:   '[?]',
+  mirror:   '[M]',
+  plug:     '[PLUG]',
+  book:     '[DOC]',
+  pin:      '[PIN]',
+  arrow:    '->',
+  down:     '[DL]',
+  reload:   '[R]',
+  stop:     '[X]',
+  chart:    '[#]',
+  thought:  '[.]',
+  phone:    '[TEL]',
+  feishu:   '[FS]',
+  check:    '[v]',
+} : {
+  ok:       '\u2705',     // ✅
+  fail:     '\u274C',     // ❌
+  warn:     '\u26A0\uFE0F', // ⚠️
+  info:     '\u2139\uFE0F', // ℹ️
+  pkg:      '\uD83D\uDCE6', // 📦
+  brain:    '\uD83E\uDDE0', // 🧠
+  dna:      '\uD83E\uDDEC', // 🧬
+  new:      '\uD83C\uDD95', // 🆕
+  magic:    '\uD83D\uDD2E', // 🔮
+  bot:      '\uD83E\uDD16', // 🤖
+  green:    '\uD83D\uDFE2', // 🟢
+  red:      '\uD83D\uDD34', // 🔴
+  hook:     '\uD83E\uDE9D', // 🪝
+  search:   '\uD83D\uDD0D', // 🔍
+  mirror:   '\uD83E\uDE9E', // 🪞
+  plug:     '\uD83D\uDD0C', // 🔌
+  book:     '\uD83D\uDCD6', // 📖
+  pin:      '\uD83D\uDCCC', // 📌
+  arrow:    '\u2192',     // →
+  down:     '\u2B07\uFE0F', // ⬇️
+  reload:   '\uD83D\uDD04', // 🔄
+  stop:     '\uD83D\uDEAB', // 🚫
+  chart:    '\uD83D\uDCCA', // 📊
+  thought:  '\uD83D\uDCAD', // 💭
+  phone:    '\uD83D\uDCF1', // 📱
+  feishu:   '\uD83D\uDCD8', // 📘
+  check:    '\u2714',     // ✔
+};
+
+/**
+ * Get a platform-appropriate icon by name.
+ * Usage: icon('ok') → '✅' on macOS, '[OK]' on Windows
+ */
+function icon(name) {
+  return _icons[name] || name;
+}
+
+module.exports = {
+  IS_WIN,
+  IS_MAC,
+  IS_LINUX,
+  HOME,
+  socketPath,
+  sleepSync,
+  findProcessesByPattern,
+  needsSocketCleanup,
+  icon,
+};

package/scripts/reliability-core.test.js

@@ -13,10 +13,17 @@ function mkHome(prefix = 'metame-reliability-') {
   return home;
 }
 
+function homeEnv(home) {
+  // On Windows, os.homedir() reads USERPROFILE, not HOME
+  return process.platform === 'win32'
+    ? { HOME: home, USERPROFILE: home }
+    : { HOME: home };
+}
+
 function runNode(home, code, extraEnv = {}) {
   return execFileSync(process.execPath, ['-e', code], {
     cwd: ROOT,
-    env: { ...process.env, HOME: home, ...extraEnv },
+    env: { ...process.env, ...homeEnv(home), ...extraEnv },
     encoding: 'utf8',
     timeout: 30000,
   });
@@ -25,17 +32,22 @@ function runNode(home, code, extraEnv = {}) {
 function installFakeClaude(home, body) {
   const bin = path.join(home, 'bin');
   fs.mkdirSync(bin, { recursive: true });
+  if (process.platform === 'win32') {
+    const cli = path.join(bin, 'claude.cmd');
+    fs.writeFileSync(cli, `@echo off\n${body}\n`, 'utf8');
+    return { ...homeEnv(home), PATH: `${bin};${process.env.PATH}` };
+  }
   const cli = path.join(bin, 'claude');
   fs.writeFileSync(cli, `#!/bin/sh\n${body}\n`, 'utf8');
   fs.chmodSync(cli, 0o755);
-  return { PATH: `${bin}:${process.env.PATH}` };
+  return { ...homeEnv(home), PATH: `${bin}:${process.env.PATH}` };
 }
 
 function sendSignal(home, prompt, extraEnv = {}) {
   return new Promise((resolve, reject) => {
     const child = spawn(process.execPath, [path.join(ROOT, 'scripts', 'signal-capture.js')], {
       cwd: ROOT,
-      env: { ...process.env, HOME: home, ...extraEnv },
+      env: { ...process.env, ...homeEnv(home), ...extraEnv },
       stdio: ['pipe', 'ignore', 'ignore'],
     });
     const timer = setTimeout(() => {