libero-mcp 0.2.7 → 0.2.9

package/dist/mcp/server-core.js

@@ -72,7 +72,7 @@ export function buildServer(db) {
     const matrix = createMatrixTools(statsRepo); // matrix reuses StatsRepo
     const timeline = createTimelineTools(timelineRepo);
     const timer = createTimerTools(timerRepo, timeblockRepo, db);
-    const profile = createProfileTools(profileRepo);
+    const profile = createProfileTools(profileRepo, identityRepo);
     const profileConfirm = createProfileConfirmTools(db);
     const reminder = createReminderTools(reminderRepo, undefined, db);
     const scheduler = createSchedulerTools(timeblockRepo, reminderRepo, categoryRepo);
@@ -193,7 +193,19 @@ export function buildServer(db) {
             return errorContent(r.error);
         return asContent(await tb.create(r));
     });
-    server.registerTool("timeblock.getById", { description: "按 id 获取单条时间记录", inputSchema: { id: z.string().min(1) } }, async ({ id }) => asContent(await tb.getById(id)));
+    server.registerTool("timeblock.getById", {
+        description: "按 id 获取单条时间记录。" +
+            "S41 多用户：默认按当前 user_id 过滤，跨用户查不到返回 null。",
+        inputSchema: {
+            id: z.string().min(1),
+            user_id: z.string().optional(),
+        },
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await tb.getById(rawInput.id, r.user_id));
+    });
     server.registerTool("timeblock.update", {
         description: "更新一条时间记录（标题/时间/评分/status 等）。" +
             "MV-COACH-3 Slice 4 用户主权状态机：" +
@@ -470,6 +482,38 @@ export function buildServer(db) {
             })),
         });
     });
+    server.registerTool("profile.createUser", {
+        description: "S41 多用户建档：建立新 libero 用户（父母代管模式）。" +
+            "用户体感：「帮我建一个新用户」「我要给我儿子建档」时调用。" +
+            "返回新 libero_user_id，建档后该 user_id 立即可用于所有 libero 工具调用。" +
+            "可选绑定平台 alias（如果建档时已知 chat_id）。" +
+            "⚠️ 不查重（同名不冲突）；display_name 必填；platform 和 platform_user_id 必须同时给或同时不给。",
+        inputSchema: {
+            display_name: z.string().min(1),
+            focus_areas: z.array(z.string()).optional(),
+            goals: z.string().optional(),
+            platform: z
+                .enum(["wecom", "feishu", "telegram", "discord", "signal", "unknown"])
+                .optional(),
+            platform_user_id: z.string().optional(),
+            chat_id: z.string().optional(),
+        },
+    }, async (rawInput) => {
+        try {
+            const result = await profile.createUser({
+                display_name: rawInput.display_name,
+                focus_areas: rawInput.focus_areas,
+                goals: rawInput.goals,
+                platform: rawInput.platform,
+                platform_user_id: rawInput.platform_user_id,
+                chat_id: rawInput.chat_id,
+            });
+            return asContent(result);
+        }
+        catch (e) {
+            return errorContent(e.message);
+        }
+    });
     // ============================================================
     // reminder (6 tools — S11)
     // ============================================================

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

@@ -1,6 +1,10 @@
+import { randomUUID } from "node:crypto";
 /** Validate and delegate profile operations to the repository.
- *  ADR-0001: Dependency-injected — the caller provides the repo. */
-export function createProfileTools(repo) {
+ *  ADR-0001: Dependency-injected — the caller provides the repo.
+ *
+ *  S41（2026-08-06）：新增可选 identityRepo 参数，用于 createUser 工具。
+ *  不传 = 不支持 createUser（向后兼容）。 */
+export function createProfileTools(repo, identityRepo) {
     return {
         async get(userId) {
             if (!userId) {
@@ -49,48 +53,48 @@ export function createProfileTools(repo) {
             });
         },
         /**
-         * S40 slice 2（2026-08-02）：Atomic claim — 多 cron 并发场景的"赢者通吃"。
+         * S40 slice 2 → slice 3（2026-08-03 升级）：Atomic claim。
          *
-         * 解决问题：nag fan-out 时飞书 cron + 企微 cron 同时启动，都看到 settings=null
-         * → 都发 → 违反产品叙事「同步响一次」。
+         * 历史：slice 2 是 tool 层「读-检查-写」，集成测试量出 100% race（每次并发都双发）。
+         * slice 3 改为：repo 提供 claimNudgeAtomic（用 better-sqlite3 db.transaction 包整段）。
          *
-         * Atomic 原子（better-sqlite3 transaction）：BEGIN → SELECT → 检查 window → UPDATE → COMMIT。
-         * window_minutes 内只有第一个调用赢（won=true），后续调用返回 won=false 但不写时间戳。
+         * 兼容降级：如果 repo 没实现 claimNudgeAtomic（如 InMemoryProfileRepo），
+         * 走旧版非原子逻辑——但会在 §4.5 静默折叠意义上「未声明」，所以打 WARN 日志。
          *
-         * 调用方（cron prompt）必须看 won：
-         *   won=true  → 输出问候
-         *   won=false → 输出 [SILENT]（已被别的 cron 抢先）
-         *
-         * 默认 window = 5 分钟，覆盖 cron 启动间隔差。
+         * @4.5 显式声明：sqlite transaction 是真 atomic（阻塞 event loop + 写锁）。
+         * 在 in-memory repo 下无 atomic 保护——但 in-memory 只在测试场景，无生产风险。
          */
         async claimNudge(input) {
             if (!input.user_id) {
                 throw new Error("user_id 为必填参数");
             }
             const windowMinutes = input.window_minutes ?? 5;
+            // 优先用 repo 提供的 atomic 版本（sqlite production path）
+            if (typeof repo.claimNudgeAtomic === "function") {
+                return repo.claimNudgeAtomic({
+                    user_id: input.user_id,
+                    window_minutes: windowMinutes,
+                });
+            }
+            // 兼容降级（in-memory / 测试）：非原子，无并发安全保证
+            // ⚠️ §4.5 声明：此分支不是 atomic，仅用于无并发的测试场景
+            // eslint-disable-next-line no-console
+            console.warn("[claimNudge] repo.claimNudgeAtomic 未实现，降级到非原子路径。" +
+                "仅测试场景安全，生产必须用 SqliteProfileRepo。");
             const windowMs = windowMinutes * 60 * 1000;
             const now = new Date();
             const nowIso = now.toISOString();
-            // Atomic block: 用 repo 提供的 transaction hook
-            // 但 ProfileRepo interface 没有 transaction API —— 通过 repo.upsert 的「读-合并-写」语义实现
-            // 真正的 atomic 要靠 sqlite 层，但为兼容 in-memory repo，我们在 tool 层用读后写
-            // ⚠️ §4.5 静默折叠声明：这不是 100% atomic（读-写之间有 race window）
-            //    但 sqlite 层的默认 statement-level atomic 在实践中足够（< 1ms 窗口）
-            //    真 100% atomic 需要 SqliteProfileRepo 暴露 transaction 接口（slice 3 补）
             const existing = await repo.getById(input.user_id);
             const existingSettings = existing?.settings != null
                 ? existing.settings
                 : {};
-            // 检查：window 内是否已被写过
             const lastNudgeAt = existingSettings.last_inactivity_nudge_at;
             if (typeof lastNudgeAt === "string") {
                 const ageMs = now.getTime() - new Date(lastNudgeAt).getTime();
                 if (ageMs < windowMs) {
-                    // window 内已被 claim，本次输
                     return { won: false, profile: existing };
                 }
             }
-            // 赢，写时间戳
             const merged = {
                 ...existingSettings,
                 last_inactivity_nudge_at: nowIso,
@@ -101,5 +105,71 @@ export function createProfileTools(repo) {
             });
             return { won: true, profile };
         },
+        /**
+         * S41（2026-08-06）：建新 libero 用户（管理员代管模式）。
+         *
+         * 产品定位：「帮我建一个新用户」「我要给我儿子建档」时调用。
+         * 不查重（同名不冲突）、不强制绑 alias、不要求 focus_areas/goals（最小建档）。
+         *
+         * 必须传 identityRepo 才可用（slice 1：server-core 启动时注入）。
+         *
+         * 输入校验（§4.5 显式）：
+         *   - display_name 必填非空
+         *   - platform 和 platform_user_id 必须同时给或同时不给
+         *
+         * 副作用：建 identity → 建 profile（空白）→ （可选）绑 alias
+         * 失败语义：identity 建成功但 profile 建失败 → 抛错，identity 留在表里
+         *   （可接受：identity 没有 profile 也能用，下次 profile.get 会触发 auto-create；
+         *    不做事务回滚是 §3 #4 最小可逆单位原则。）
+         */
+        async createUser(input) {
+            if (!identityRepo) {
+                throw new Error("createUser 需要 identityRepo（server-core 启动时未注入，本部署不支持多用户建档）");
+            }
+            if (!input.display_name || input.display_name.trim() === "") {
+                throw new Error("display_name 为必填参数且不能为空");
+            }
+            const hasPlatform = !!input.platform;
+            const hasPlatformUserId = !!input.platform_user_id;
+            if (hasPlatform !== hasPlatformUserId) {
+                throw new Error("platform 和 platform_user_id 必须同时给或同时不给（绑定平台 alias 时两者都需要）");
+            }
+            const libero_user_id = `u_libero_${randomUUID().replace(/-/g, "").slice(0, 16)}`;
+            await identityRepo.createIdentity({
+                libero_user_id,
+                display_name: input.display_name,
+            });
+            const settings = {};
+            if (input.focus_areas && input.focus_areas.length > 0) {
+                settings.focus_areas = input.focus_areas;
+            }
+            if (input.goals && input.goals.trim() !== "") {
+                settings.goals = input.goals;
+            }
+            await repo.upsert({
+                user_id: libero_user_id,
+                display_name: input.display_name,
+                settings: Object.keys(settings).length > 0 ? settings : undefined,
+            });
+            let bound_alias;
+            if (hasPlatform && hasPlatformUserId) {
+                await identityRepo.bindAlias({
+                    libero_user_id,
+                    platform: input.platform,
+                    platform_user_id: input.platform_user_id,
+                    chat_id: input.chat_id,
+                });
+                bound_alias = {
+                    platform: input.platform,
+                    platform_user_id: input.platform_user_id,
+                    chat_id: input.chat_id ?? null,
+                };
+            }
+            return {
+                libero_user_id,
+                display_name: input.display_name,
+                bound_alias,
+            };
+        },
     };
 }

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

@@ -552,6 +552,65 @@ export class SqliteProfileRepo {
         }
         return (await this.getById(input.user_id));
     }
+    /**
+     * S40 slice 3：Atomic claim nudge。
+     *
+     * 用 better-sqlite3 的 `db.transaction()` 把「SELECT → 检查 window → UPDATE → 返回」
+     * 包成一个原子单元。better-sqlite3 是**同步**的——transaction 期间阻塞 event loop，
+     * 第二个调用根本没机会插入。
+     *
+     * 注意：transaction 返回的函数是同步的，必须在同步上下文调用（不能 await）。
+     * 这里包装成 async 只是为了匹配 ProfileRepo interface，内部完全同步执行。
+     */
+    async claimNudgeAtomic(input) {
+        const windowMs = input.window_minutes * 60 * 1000;
+        const now = new Date();
+        const nowIso = now.toISOString();
+        const nowDb = nowIso.replace("T", " ").replace("Z", "");
+        const rowToProfile = (r) => ({
+            id: r.id,
+            display_name: r.display_name,
+            expectations: r.expectations,
+            settings: r.settings != null ? JSON.parse(r.settings) : null,
+            created_at: r.created_at,
+            updated_at: r.updated_at,
+        });
+        const selectStmt = this.db.prepare("SELECT id, display_name, expectations, settings, created_at, updated_at FROM user_profile WHERE id = ? AND deleted_at IS NULL");
+        const updateStmt = this.db.prepare(`UPDATE user_profile SET settings = ?, updated_at = ? WHERE id = ?`);
+        const insertStmt = this.db.prepare(`INSERT INTO user_profile (id, display_name, expectations, settings, created_at, updated_at)
+       VALUES (?, '', NULL, ?, ?, ?)`);
+        // transaction 函数（同步）。better-sqlite3 在 transaction() 期间阻塞 event loop，
+        // 第二个并发调用必须等第一个 COMMIT 才能进入 BEGIN。
+        const txn = this.db.transaction(() => {
+            const row = selectStmt.get(input.user_id);
+            const existingSettings = row?.settings != null
+                ? JSON.parse(row.settings)
+                : {};
+            const lastNudgeAt = existingSettings.last_inactivity_nudge_at;
+            if (typeof lastNudgeAt === "string") {
+                const ageMs = now.getTime() - new Date(lastNudgeAt).getTime();
+                if (ageMs < windowMs) {
+                    return { won: false, profile: rowToProfile(row) };
+                }
+            }
+            const merged = {
+                ...existingSettings,
+                last_inactivity_nudge_at: nowIso,
+            };
+            const settingsJson = JSON.stringify(merged);
+            if (row) {
+                updateStmt.run(settingsJson, nowDb, input.user_id);
+            }
+            else {
+                insertStmt.run(input.user_id, settingsJson, nowDb, nowDb);
+            }
+            const updated = selectStmt.get(input.user_id);
+            return { won: true, profile: rowToProfile(updated) };
+        });
+        // BEGIN IMMEDIATE：立刻拿写锁，防止 deferred 模式下读-写升级冲突
+        // better-sqlite3 API：transaction 函数有 .immediate(args) 变种
+        return txn.immediate();
+    }
 }
 // ============================================================
 // SqliteReminderRepo (S11 — reminder persistence)

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

@@ -28,8 +28,14 @@ export function createTimeBlockTools(repo, db) {
             const row = await repo.create({ ...input, user_id: userId });
             return { ...row, target_user_label: labelFor(db, userId) };
         },
-        async getById(id) {
-            return repo.getById(id);
+        async getById(id, userId) {
+            const row = await repo.getById(id);
+            // S41 multi-user isolation: 如果调用方传了 user_id，校验 ownership。
+            // 没传 user_id = 旧行为（单用户 / 兼容路径），不阻塞。
+            if (row && userId && row.user_id !== userId) {
+                return null;
+            }
+            return row;
         },
         async list(filters) {
             if (!filters.user_id) {

package/package.json

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