libero-mcp 0.2.15 → 0.2.17

package/data/migrations/013_identity_managed_by.sql

@@ -0,0 +1,3 @@
+-- S44 (2026-08-07): managed_by field for代管 forwarding
+-- 代管人 libero_user_id（NULL = 自己接收追问；非 NULL = 追问发给代管人）
+ALTER TABLE user_identity ADD COLUMN managed_by TEXT;

package/dist/data/migrations/013_identity_managed_by.sql

@@ -0,0 +1,3 @@
+-- S44 (2026-08-07): managed_by field for代管 forwarding
+-- 代管人 libero_user_id（NULL = 自己接收追问；非 NULL = 追问发给代管人）
+ALTER TABLE user_identity ADD COLUMN managed_by TEXT;

package/dist/mcp/server-core.js

@@ -373,7 +373,9 @@ function buildToolRegistry(ctx) {
     // ============================================================
     tools.push({
         name: "matrix.renderMatrix",
-        description: "时间×评分四象限矩阵（能耗黑洞/保持区/亮点区/可放弃）",
+        description: "时间×评分四象限矩阵（能耗黑洞/保持区/亮点区/可放弃）。" +
+            "⚠️ 用户说「时间矩阵 / 时间表 / 看日程 / 今天时间表」时**不要**调本工具——那些是指 emoji 时间块视图，请改调 schedule.timeline。" +
+            "本工具仅用于：阶段复盘（这周/最近 N 天）+ 已评分记录的象限分析。",
         inputSchema: {
             user_id: z.string().optional(),
             from: z.string().optional(),
@@ -393,7 +395,7 @@ function buildToolRegistry(ctx) {
     tools.push({
         name: "schedule.timeline",
         description: "看日程/复盘的首选视图：emoji 矩阵+细项表格，含计划/计时中/未回应/实绩全状态。" +
-            "用户说「看今天/看日程/在干啥/复盘/接下来 N 小时」时调本工具，并直接 echo rendered_text（不重写、不改格式）。" +
+            "用户说「看今天/看日程/在干啥/复盘/接下来 N 小时/时间矩阵/时间表/今天时间表」时调本工具，并直接 echo rendered_text（不重写、不改格式）。" +
             "不要调 scheduler.listSchedules（那是内部排程查询，不是用户视图）。",
         inputSchema: {
             user_id: z.string().optional(),
@@ -644,6 +646,47 @@ function buildToolRegistry(ctx) {
             }
         },
     });
+    tools.push({
+        name: "profile.getManager",
+        description: "S44 代管转发：查某用户的代管人（managed_by + 代管人 display_name）。" +
+            "用途：扫描 cron 发现用户没自己渠道时，查 managed_by 把追问发给代管人。" +
+            "返回 managed_by=null 表示该用户没代管人（普通独立用户）。",
+        inputSchema: {
+            user_id: z.string().min(1),
+        },
+        handler: async (rawInput) => {
+            try {
+                const result = await profile.getManager({ user_id: rawInput.user_id });
+                return asContent(result);
+            }
+            catch (e) {
+                return errorContent(e.message);
+            }
+        },
+    });
+    tools.push({
+        name: "profile.setManager",
+        description: "S44 代管转发：设置或清除某用户的代管人。" +
+            "用法：profile.setManager({ user_id: '<被代管人>', managed_by: '<代管人 libero_user_id>' })。" +
+            "managed_by=null 清除代管关系；非 null 必须指向存在的 libero_user_id（FK 校验）。" +
+            "典型场景：父母给孩子建账户后，profile.setManager({ user_id: '<孩子>', managed_by: '<父母>' })。",
+        inputSchema: {
+            user_id: z.string().min(1),
+            managed_by: z.string().nullable(),
+        },
+        handler: async (rawInput) => {
+            try {
+                const result = await profile.setManager({
+                    user_id: rawInput.user_id,
+                    managed_by: rawInput.managed_by,
+                });
+                return asContent(result);
+            }
+            catch (e) {
+                return errorContent(e.message);
+            }
+        },
+    });
     // ============================================================
     // reminder (6 tools — S11)
     // ============================================================

package/dist/mcp/src/identity/in-memory.js

@@ -8,6 +8,7 @@
 export class InMemoryIdentityRepo {
     identities = new Map();
     aliases = new Map(); // key = `${platform}:${platform_user_id}`
+    managers = new Map(); // user_id → manager_user_id
     async createIdentity(input) {
         if (this.identities.has(input.libero_user_id)) {
             throw new Error(`identity already exists: libero_user_id=${input.libero_user_id}`);
@@ -60,6 +61,40 @@ export class InMemoryIdentityRepo {
         return null;
     }
     async listAllIdentities() {
-        return Array.from(this.identities.values());
+        return Array.from(this.identities.values()).map((i) => ({
+            ...i,
+            managed_by: this.managers.get(i.libero_user_id) ?? null,
+        }));
+    }
+    async getManager(libero_user_id) {
+        const id = this.identities.get(libero_user_id);
+        if (!id) {
+            throw new Error(`getManager: libero_user_id not found: ${libero_user_id}`);
+        }
+        const managedBy = this.managers.get(libero_user_id) ?? null;
+        const mgr = managedBy ? this.identities.get(managedBy) : null;
+        return {
+            libero_user_id,
+            managed_by: managedBy,
+            manager_display_name: mgr?.display_name ?? null,
+        };
+    }
+    async setManager(input) {
+        if (!this.identities.has(input.libero_user_id)) {
+            throw new Error(`setManager: libero_user_id not found: ${input.libero_user_id}`);
+        }
+        if (input.managed_by !== null) {
+            if (!this.identities.has(input.managed_by)) {
+                throw new Error(`setManager: manager libero_user_id not found: ${input.managed_by}`);
+            }
+            this.managers.set(input.libero_user_id, input.managed_by);
+        }
+        else {
+            this.managers.delete(input.libero_user_id);
+        }
+        return {
+            libero_user_id: input.libero_user_id,
+            managed_by: input.managed_by,
+        };
     }
 }

package/dist/mcp/src/profile/index.js

@@ -188,5 +188,34 @@ export function createProfileTools(repo, identityRepo) {
                 display_name: i.display_name,
             }));
         },
+        /**
+         * S44（2026-08-07）：查某用户的代管人。
+         * 用途：扫描 cron 发现用户没自己渠道时，查 managed_by 把追问发给代管人。
+         */
+        async getManager(input) {
+            if (!identityRepo) {
+                throw new Error("getManager 需要 identityRepo（本部署不支持代管转发）");
+            }
+            if (!input.user_id) {
+                throw new Error("user_id 为必填参数");
+            }
+            return identityRepo.getManager(input.user_id);
+        },
+        /**
+         * S44（2026-08-07）：设置/清除某用户的代管人。
+         * managed_by=null 清除；非 null 必须指向存在的 libero_user_id。
+         */
+        async setManager(input) {
+            if (!identityRepo) {
+                throw new Error("setManager 需要 identityRepo（本部署不支持代管转发）");
+            }
+            if (!input.user_id) {
+                throw new Error("user_id 为必填参数");
+            }
+            return identityRepo.setManager({
+                libero_user_id: input.user_id,
+                managed_by: input.managed_by,
+            });
+        },
     };
 }

package/dist/mcp/src/repo/sqlite-identity.js

@@ -78,10 +78,52 @@ export class SqliteIdentityRepo {
     }
     async listAllIdentities() {
         const rows = this.db
-            .prepare(`SELECT libero_user_id, display_name, created_at, updated_at
+            .prepare(`SELECT libero_user_id, display_name, managed_by, created_at, updated_at
          FROM user_identity
          ORDER BY created_at ASC`)
             .all();
         return rows.map((r) => ({ ...r }));
     }
+    async getManager(libero_user_id) {
+        const row = this.db
+            .prepare(`SELECT ui.libero_user_id, ui.managed_by, mgr.display_name as manager_display_name
+         FROM user_identity ui
+         LEFT JOIN user_identity mgr ON mgr.libero_user_id = ui.managed_by
+         WHERE ui.libero_user_id = ?`)
+            .get(libero_user_id);
+        if (!row) {
+            throw new Error(`getManager: libero_user_id not found: ${libero_user_id}`);
+        }
+        return {
+            libero_user_id: row.libero_user_id,
+            managed_by: row.managed_by,
+            manager_display_name: row.manager_display_name,
+        };
+    }
+    async setManager(input) {
+        // User existence check
+        const user = this.db
+            .prepare("SELECT 1 FROM user_identity WHERE libero_user_id = ?")
+            .get(input.libero_user_id);
+        if (!user) {
+            throw new Error(`setManager: libero_user_id not found: ${input.libero_user_id}`);
+        }
+        // Manager FK check (if non-null)
+        if (input.managed_by !== null) {
+            const mgr = this.db
+                .prepare("SELECT 1 FROM user_identity WHERE libero_user_id = ?")
+                .get(input.managed_by);
+            if (!mgr) {
+                throw new Error(`setManager: manager libero_user_id not found: ${input.managed_by}`);
+            }
+        }
+        const now = new Date().toISOString().replace("T", " ").replace("Z", "");
+        this.db
+            .prepare("UPDATE user_identity SET managed_by = ?, updated_at = ? WHERE libero_user_id = ?")
+            .run(input.managed_by, now, input.libero_user_id);
+        return {
+            libero_user_id: input.libero_user_id,
+            managed_by: input.managed_by,
+        };
+    }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libero-mcp",
-  "version": "0.2.15",
+  "version": "0.2.17",
   "description": "AI 时间管理教练 MCP 工具集——时间块记录、统计、矩阵诊断、计时、分类、profile",
   "license": "MIT",
   "author": "amosyuan",