libero-mcp 0.2.2 → 0.2.4

package/COLD_START.md

@@ -1,15 +1,15 @@
-# libero 冷启动（装机后、reload 前）
+# libero 冷启动（host agent 专用，不是用户手册）
 
-> 给 Hermes / OpenClaw 等 host agent 读。装完包后**先把下面欢迎发给用户**，再 `/reload-mcp`。
+> **禁止**把本文当成用户步骤（「请你让 agent 读这个文件」= 产品失败）。  
+> 用户只说「帮我装 libero」或跑 `npm i -g libero-mcp@latest`。欢迎必须由 host **自动**发出。
 
-## 装机顺序
+## Host 在装机时自动做
 
-1. `npm i -g libero-mcp@latest`
-2. 配置 `mcp_servers.libero.command: libero-mcp`（如需）
-3. **先介绍**：把「欢迎原文」原样发给用户（不要列工具名、不要问 user_id）
-4. **再刷新**：`/reload-mcp`（或等价）挂上工具
+1. 跑 `npm i -g libero-mcp@latest`（postinstall 会在 stderr 打印 `LIBERO_HOST_ACTION` + 欢迎原文）
+2. **立刻**把欢迎原文作为下一条对用户的回复发出（不要列工具、不要问 user_id）
+3. 再写 `mcp_servers.libero.command: libero-mcp`（如需）并 `/reload-mcp`
 
-## 欢迎原文（原样发给用户）
+## 欢迎原文
 
 ```
 你好，我是 libero，帮你管时间和精力。

package/README.md

@@ -10,43 +10,25 @@ AI 辅助的精力管理教练：观察实绩 → 发现问题 → 对齐方案
 npm i -g libero-mcp@latest
 ```
 
-### 给 host agent（Hermes / OpenClaw）的装机顺序
+或对你的 agent 说一句：**帮我装 libero**。
 
-1. 装包并写好 MCP 配置  
-2. **先介绍**：把 [`COLD_START.md`](COLD_START.md) 里的欢迎原文发给用户（不要列工具、不要问 user_id）  
-3. **再刷新**：`/reload-mcp`（或等价）挂上工具  
+装完后你会直接看到欢迎与试用例句（计时 / 日程 / 拆任务 / 看数据 / 复盘）。  
+不需要再配置、不需要起 user_id、不需要提醒 agent「去读某个文件」。
 
-用户装完后应直接看到欢迎与试用例句，而不是配置问卷。
-
-### 用户怎么试
-
-装完后直接说：
+试试说：
 
 > 开始计时写代码
 
-或：
-
-> 这周时间都花哪儿了？帮我复盘一下
-
 ## 能说什么
 
 | 想做的事 | 这样说 |
 |---|---|
 | 开始一段专注 | "开始计时写代码" / "开个 25 分钟番茄钟读书" |
 | 停下来 | "停一下" / "看看今天计了多久" |
-| 安排日程 | "明天 9 点到 11 点写报告" / "下周二下午开会" |
-| 看时间分布 | "这周时间都花哪儿了" / "看看今天的四象限" |
-| 复盘 | "复盘一下这周" / "帮我分析最近的时间使用" |
+| 安排日程 | "明天 9 点到 11 点写报告" |
+| 看时间分布 | "这周时间都花哪儿了" |
+| 复盘 | "复盘一下这周" |
 | 拆任务 | "这个任务太大，帮我拆一下" |
-| 安排提醒 | "明天 8 点提醒我打卡" |
-
-## 数据存在哪
-
-默认在 `~/.libero/libero.db`（SQLite）。想换位置：
-
-```bash
-DB_PATH=/your/path.db libero-mcp
-```
 
 ## 升级
 
@@ -54,11 +36,8 @@ DB_PATH=/your/path.db libero-mcp
 npm update -g libero-mcp
 ```
 
-DB schema 升级在启动时自动跑，不用手工干预。
-
-## 给开发者
+## 给开发者 / host 实现者
 
-- 冷启动文案：[COLD_START.md](COLD_START.md)（与 MCP `instructions` 同源）
+- Host 装机自动行为见 [COLD_START.md](COLD_START.md)（**不是**用户步骤）
 - 协作宪法：[AGENTS.md](AGENTS.md)
-- 部署细节：[docs/operations/deploy-to-hermes.md](docs/operations/deploy-to-hermes.md)
-- Skills：`skills/`（libero-coach / libero-record / libero-onboarding / libero-decompose）
+- 排查：[docs/operations/deploy-to-hermes.md](docs/operations/deploy-to-hermes.md)

package/data/migrations/011_profile_default_confirmed.sql

@@ -0,0 +1,4 @@
+-- 011_profile_default_confirmed: MV-COACH-1 首次确认时间戳
+-- 仅 ADD COLUMN，不改既有字段语义
+
+ALTER TABLE user_profile ADD COLUMN default_confirmed_at TEXT;

package/data/schema.sql

@@ -5,6 +5,10 @@ CREATE TABLE IF NOT EXISTS user_profile (
   id TEXT PRIMARY KEY,
   display_name TEXT NOT NULL DEFAULT '',
   expectations TEXT,
+  -- 005_profile_settings: 结构化约定存为 JSON
+  settings TEXT,
+  -- 011_profile_default_confirmed: MV-COACH-1 首次确认时间戳
+  default_confirmed_at TEXT,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at TEXT NOT NULL DEFAULT (datetime('now')),
   deleted_at TEXT

package/dist/data/migrations/011_profile_default_confirmed.sql

@@ -0,0 +1,4 @@
+-- 011_profile_default_confirmed: MV-COACH-1 首次确认时间戳
+-- 仅 ADD COLUMN，不改既有字段语义
+
+ALTER TABLE user_profile ADD COLUMN default_confirmed_at TEXT;

package/dist/data/schema.sql

@@ -5,6 +5,10 @@ CREATE TABLE IF NOT EXISTS user_profile (
   id TEXT PRIMARY KEY,
   display_name TEXT NOT NULL DEFAULT '',
   expectations TEXT,
+  -- 005_profile_settings: 结构化约定存为 JSON
+  settings TEXT,
+  -- 011_profile_default_confirmed: MV-COACH-1 首次确认时间戳
+  default_confirmed_at TEXT,
   created_at TEXT NOT NULL DEFAULT (datetime('now')),
   updated_at TEXT NOT NULL DEFAULT (datetime('now')),
   deleted_at TEXT

package/dist/mcp/cold-start.js

@@ -1,13 +1,9 @@
 /**
  * Cold-start copy for host agents (Hermes / OpenClaw) and MCP server instructions.
  *
- * Timing (user perspective):
- * 1. After npm install / config written
- * 2. FIRST show COLD_START_WELCOME to the user (before tools are live)
- * 3. THEN /reload-mcp (or equivalent) to attach tools
- *
- * MCP cannot push a chat message by itself — hosts must speak this text in the
- * install turn. Server `instructions` reinforce the same rules after connect.
+ * User perspective: one line `npm i -g` or "帮我装 libero" → welcome appears.
+ * Host perspective: postinstall prints LIBERO_HOST_ACTION; host relays welcome,
+ * then /reload-mcp. Never ask the human to coach the agent.
  */
 /** Short welcome users should see (natural language only). */
 export const COLD_START_WELCOME = `你好，我是 libero，帮你管时间和精力。
@@ -28,23 +24,20 @@ export function buildServerInstructions() {
     return [
         "# libero — 时间与精力管理助手",
         "",
-        "## 装机顺序（硬规矩）",
-        "1. npm i -g libero-mcp@latest 配置好 mcp_servers 后：",
-        "2. **先介绍**：把下面「冷启动欢迎」原样发给用户（不要列工具名 / 不要问配置）",
-        "3. **再 reload**：用户看完介绍后，再执行 /reload-mcp（或等价刷新）挂上工具",
-        "4. 禁止在介绍或首次对话里索取 user_id / DB_PATH / YAML",
+        "## 装机（对 host agent，不是对用户）",
+        "用户只说「帮我装 libero」或跑 npm i -g。**禁止**让用户再提醒你读 md / 执行命令。",
+        "npm postinstall 会打印 LIBERO_HOST_ACTION + 欢迎原文：你的**下一条对用户回复**必须是该欢迎，然后再 /reload-mcp。",
+        "禁止问 user_id；禁止列工具表。",
         "",
         "## 冷启动欢迎（原样发给用户）",
         COLD_START_WELCOME,
         "",
         "## user_id（硬纪律）",
-        "- 调用任何需要 user_id 的工具时：从当前会话上下文静默取（平台用户 ID / 会话稳定 ID）",
-        "- 取不到时用稳定占位 local:default",
-        "- **禁止问用户起 user_id**；禁止输出 wechat_你的ID / test_1 这类工程师问卷",
-        "- 可选问称呼（display_name），一句即可，可跳过",
+        "- 从当前会话上下文静默取；取不到用 local:default",
+        "- **禁止问用户起 user_id**；禁止 wechat_你的ID / test_1 问卷",
         "",
         "## 对用户说话",
         "- 只说自然语言能做什么；不要提 MCP / 工具表 / schema / 数据库",
-        "- 用户选了试用例句 → 直接执行对应能力，不要重复整段介绍",
+        "- 用户选了试用例句 → 直接执行，不要重复整段介绍",
     ].join("\n");
 }