libero-mcp 0.2.3 → 0.2.4

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/server-core.js

@@ -1,17 +1,20 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { SqliteCategoryRepo, SqliteTimeBlockRepo, SqliteStatsRepo, SqliteTimerRepo, SqliteProfileRepo, SqliteReminderRepo, } from "./src/repo/sqlite.js";
+import { SqliteCategoryRepo, SqliteTimeBlockRepo, SqliteStatsRepo, SqliteTimerRepo, SqliteProfileRepo, SqliteReminderRepo, SqliteTimelineRepo, } from "./src/repo/sqlite.js";
 import { createCategoryTools } from "./src/categories/index.js";
 import { createTimeBlockTools } from "./src/timeblock/index.js";
 import { createStatsTools } from "./src/stats/index.js";
 import { createMatrixTools } from "./src/matrix/index.js";
+import { createTimelineTools } from "./src/timeline/index.js";
 import { createTimerTools } from "./src/timer/index.js";
 import { createProfileTools } from "./src/profile/index.js";
+import { createProfileConfirmTools } from "./src/profile/confirm-default.js";
 import { createReminderTools } from "./src/reminder/index.js";
 import { createSchedulerTools } from "./src/scheduler/index.js";
 import { createTaskTools } from "./src/task/index.js";
 import { nowLocal, formatTime, parseTime } from "./src/clock/index.js";
 import { buildServerInstructions } from "./cold-start.js";
+import { resolveDefaultUserId, logResolvedDefaultUserId, } from "./src/user-id-resolver.js";
 /** Wrap any tool result as MCP text content (JSON). Void results become {ok:true}. */
 function asContent(result) {
     return {
@@ -23,12 +26,34 @@ function asContent(result) {
         ],
     };
 }
+/** Inject default user_id when LLM omits it; otherwise return isError payload. */
+export function makeUserIdInjector(defaultUserId) {
+    return function inject(input) {
+        if (input.user_id)
+            return input;
+        if (defaultUserId)
+            return { ...input, user_id: defaultUserId };
+        return {
+            error: "user_id is required (no default configured: set LIBERO_DEFAULT_USER_ID or have at least one non-system user_profile)",
+        };
+    };
+}
+export function errorContent(msg) {
+    return {
+        content: [{ type: "text", text: JSON.stringify({ error: msg }) }],
+        isError: true,
+    };
+}
 /**
  * Build the libero MCP server on a given DB connection.
  * Tools throw Error on business violations; handlers let them propagate —
  * the SDK turns thrown errors into MCP tool errors (isError) preserving the message.
  */
 export function buildServer(db) {
+    // MV-COACH-3 Slice 2: resolve default user_id once at server build
+    const defaultUser = resolveDefaultUserId({ db, env: process.env });
+    logResolvedDefaultUserId(defaultUser);
+    const injector = makeUserIdInjector(defaultUser.userId);
     // ── construct repos (S10 §3.3) ──
     const categoryRepo = new SqliteCategoryRepo(db);
     const timeblockRepo = new SqliteTimeBlockRepo(db);
@@ -36,14 +61,17 @@ export function buildServer(db) {
     const timerRepo = new SqliteTimerRepo(db);
     const profileRepo = new SqliteProfileRepo(db);
     const reminderRepo = new SqliteReminderRepo(db);
+    const timelineRepo = new SqliteTimelineRepo(db);
     // ── inject tool factories ──
     const categories = createCategoryTools(categoryRepo);
-    const tb = createTimeBlockTools(timeblockRepo);
+    const tb = createTimeBlockTools(timeblockRepo, db);
     const stats = createStatsTools(statsRepo);
     const matrix = createMatrixTools(statsRepo); // matrix reuses StatsRepo
-    const timer = createTimerTools(timerRepo, timeblockRepo);
+    const timeline = createTimelineTools(timelineRepo);
+    const timer = createTimerTools(timerRepo, timeblockRepo, db);
     const profile = createProfileTools(profileRepo);
-    const reminder = createReminderTools(reminderRepo);
+    const profileConfirm = createProfileConfirmTools(db);
+    const reminder = createReminderTools(reminderRepo, undefined, db);
     const scheduler = createSchedulerTools(timeblockRepo, reminderRepo, categoryRepo);
     const task = createTaskTools(db);
     // instructions 必须放在第 2 参 ServerOptions（不是 serverInfo）—— SDK 只从 options 读
@@ -59,49 +87,94 @@ export function buildServer(db) {
     server.registerTool("timer.start", {
         description: "开始一个计时会话",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             event: z.string().min(1),
             categoryId: z.string().optional(),
             task_id: z.string().optional(),
         },
-    }, async ({ user_id, event, categoryId, task_id }) => asContent(await timer.start(user_id, event, categoryId, task_id)));
-    server.registerTool("timer.pause", { description: "暂停当前计时", inputSchema: { user_id: z.string().min(1) } }, async ({ user_id }) => asContent(await timer.pause(user_id)));
-    server.registerTool("timer.resume", { description: "恢复已暂停的计时", inputSchema: { user_id: z.string().min(1) } }, async ({ user_id }) => asContent(await timer.resume(user_id)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.start(r.user_id, r.event, r.categoryId, r.task_id, r.target_user_id));
+    });
+    server.registerTool("timer.pause", { description: "暂停当前计时", inputSchema: { user_id: z.string().optional() } }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.pause(r.user_id));
+    });
+    server.registerTool("timer.resume", { description: "恢复已暂停的计时", inputSchema: { user_id: z.string().optional() } }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.resume(r.user_id));
+    });
     server.registerTool("timer.stop", {
         description: "停止计时并返回记录（传 rating 时自动落盘 timeblock）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             rating: z.number().min(1).max(5).optional(),
             rating_reason: z.string().optional(),
         },
-    }, async ({ user_id, rating, rating_reason }) => asContent(await timer.stop(user_id, { rating, rating_reason })));
-    server.registerTool("timer.status", { description: "查询某用户当前计时状态", inputSchema: { user_id: z.string().min(1) } }, async ({ user_id }) => asContent(await timer.status(user_id)));
-    server.registerTool("timer.elapsed", { description: "查询当前计时已过毫秒数", inputSchema: { user_id: z.string().min(1) } }, async ({ user_id }) => asContent(await timer.elapsed(user_id)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.stop(r.user_id, {
+            rating: r.rating,
+            rating_reason: r.rating_reason,
+        }));
+    });
+    server.registerTool("timer.status", { description: "查询某用户当前计时状态", inputSchema: { user_id: z.string().optional() } }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.status(r.user_id));
+    });
+    server.registerTool("timer.elapsed", { description: "查询当前计时已过毫秒数", inputSchema: { user_id: z.string().optional() } }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.elapsed(r.user_id));
+    });
     server.registerTool("timer.statusAll", { description: "查询所有用户的当前计时状态（调试/兜底用）", inputSchema: {} }, async () => asContent(await timer.statusAll()));
     // ── S26: pomodoro v1 tools ──
     server.registerTool("timer.startFocus", {
         description: "开始一个专注计时（番茄钟），带目标时长",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             event: z.string().min(1),
             focusMin: z.number().positive().optional(),
             categoryId: z.string().optional(),
             task_id: z.string().optional(),
         },
-    }, async ({ user_id, event, focusMin, categoryId, task_id }) => asContent(await timer.startFocus(user_id, event, focusMin, categoryId, task_id)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.startFocus(r.user_id, r.event, r.focusMin, r.categoryId, r.task_id));
+    });
     server.registerTool("timer.remaining", {
         description: "查询专注计时剩余时间（负数=超时）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
         },
-    }, async ({ user_id }) => asContent(await timer.remaining(user_id)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timer.remaining(r.user_id));
+    });
     // ============================================================
     // timeblock (5 tools — single-object args)
     // ============================================================
     server.registerTool("timeblock.create", {
         description: "创建一条时间记录",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             title: z.string().min(1),
             category_id: z.string().optional(),
             start_time: z.string(),
@@ -111,12 +184,24 @@ export function buildServer(db) {
             rating_reason: z.string().optional(),
             notes: z.string().optional(),
         },
-    }, async (input) => asContent(await tb.create(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            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.update", {
-        description: "更新一条时间记录",
+        description: "更新一条时间记录（标题/时间/评分/status 等）。" +
+            "MV-COACH-3 Slice 4 用户主权状态机：" +
+            "① 开工 cron 触发到点 → status='unverified'（等用户核实，**不计入实绩**）；" +
+            "② 用户确认执行（主动开始计时 / 回报「执行了」/ 追问后答执行了）→ status='completed'（**唯一计入实绩**）；" +
+            "③ 用户答「没执行」→ 不改 status，直接 timeblock.remove 软删（留 deleted_at 可复盘，不进实绩统计）；" +
+            "④ 用户一直不答 → 保持 unverified，永远等（不自动判死）。" +
+            "⚠️ LLM 不能擅自把 planned/unverified 升级到 completed——只有用户确认才能升。",
         inputSchema: {
             id: z.string().min(1),
+            target_user_id: z.string().min(1).optional(),
             title: z.string().optional(),
             category_id: z.string().optional(),
             start_time: z.string().optional(),
@@ -125,14 +210,22 @@ export function buildServer(db) {
             rating: z.number().min(1).max(5).optional(),
             rating_reason: z.string().optional(),
             notes: z.string().optional(),
+            status: z.enum(["planned", "unverified", "completed"]).optional(),
         },
     }, async ({ id, ...rest }) => asContent(await tb.update(id, rest)));
-    server.registerTool("timeblock.remove", { description: "软删除一条时间记录", inputSchema: { id: z.string().min(1) } }, async ({ id }) => asContent(await tb.remove(id)));
+    server.registerTool("timeblock.remove", {
+        description: "软删除一条时间记录",
+        inputSchema: {
+            id: z.string().min(1),
+            target_user_id: z.string().min(1).optional(),
+        },
+    }, async ({ id, target_user_id }) => asContent(await tb.remove(id, { target_user_id })));
     server.registerTool("timeblock.restore", { description: "恢复一条已软删除的时间记录", inputSchema: { id: z.string().min(1) } }, async ({ id }) => asContent(await tb.restore(id)));
     server.registerTool("timeblock.list", {
         description: "按条件查询时间记录列表",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             date: z.string().optional(),
             from: z.string().optional(),
             to: z.string().optional(),
@@ -141,39 +234,81 @@ export function buildServer(db) {
             limit: z.number().optional(),
             offset: z.number().optional(),
         },
-    }, async (input) => asContent(await tb.list(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await tb.list(r));
+    });
     // ============================================================
     // stats (2 tools — single-object filters)
     // ============================================================
     server.registerTool("stats.summarize", {
         description: "按分类汇总时间统计（占比/记录数）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             from: z.string().optional(),
             to: z.string().optional(),
             category_id: z.string().optional(),
         },
-    }, async (input) => asContent(await stats.summarize(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await stats.summarize(r));
+    });
     server.registerTool("stats.dailyBreakdown", {
         description: "按天×分类拆分时间明细",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             from: z.string().optional(),
             to: z.string().optional(),
             category_id: z.string().optional(),
         },
-    }, async (input) => asContent(await stats.dailyBreakdown(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await stats.dailyBreakdown(r));
+    });
     // ============================================================
     // matrix (1 tool — single-object filters, reuses StatsRepo)
     // ============================================================
     server.registerTool("matrix.renderMatrix", {
         description: "时间×评分四象限矩阵（能耗黑洞/保持区/亮点区/可放弃）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            from: z.string().optional(),
+            to: z.string().optional(),
+        },
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await matrix.renderMatrix(r));
+    });
+    // ============================================================
+    // schedule.timeline (emoji matrix + detail table)
+    // ============================================================
+    server.registerTool("schedule.timeline", {
+        description: "看日程/复盘的首选视图：emoji 矩阵+细项表格，含计划/计时中/未回应/实绩全状态。" +
+            "用户说「看今天/看日程/在干啥/复盘/接下来 N 小时」时调本工具，并直接 echo rendered_text（不重写、不改格式）。" +
+            "不要调 scheduler.listSchedules（那是内部排程查询，不是用户视图）。",
+        inputSchema: {
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             from: z.string().optional(),
             to: z.string().optional(),
+            format: z.enum(["emoji", "ascii"]).optional(),
         },
-    }, async (input) => asContent(await matrix.renderMatrix(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await timeline.renderTimeline(r));
+    });
     // ============================================================
     // clock (3 tools — pure functions, no repo)
     // ============================================================
@@ -199,12 +334,17 @@ export function buildServer(db) {
     // ============================================================
     server.registerTool("profile.get", {
         description: "获取用户 profile（含结构化约定）",
-        inputSchema: { user_id: z.string().min(1) },
-    }, async ({ user_id }) => asContent(await profile.get(user_id)));
+        inputSchema: { user_id: z.string().optional() },
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await profile.get(r.user_id));
+    });
     server.registerTool("profile.upsert", {
-        description: "创建或更新用户 profile。user_id 从会话上下文静默取，禁止向用户索取。",
+        description: "创建或更新用户 profile（display_name / expectations / settings）。首次确认请用 profile.confirm_default。",
         inputSchema: {
-            user_id: z.string().min(1).describe("从会话上下文静默取；禁止问用户"),
+            user_id: z.string().optional(),
             display_name: z.string().optional(),
             expectations: z.string().optional(),
             settings: z
@@ -212,20 +352,40 @@ export function buildServer(db) {
                 .passthrough()
                 .optional(),
         },
-    }, async (input) => asContent(await profile.upsert(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await profile.upsert(r));
+    });
+    server.registerTool("profile.confirm_default", {
+        description: "首次写入前确认默认用户：写入 user_profile，设置 display_name 与 default_confirmed_at。display_name 重名则拒绝。",
+        inputSchema: {
+            platform_user_id: z.string().min(1),
+            display_name: z.string().min(1),
+        },
+    }, async (input) => asContent(await profileConfirm.confirmDefault(input)));
     // ============================================================
     // reminder (6 tools — S11)
     // ============================================================
     server.registerTool("reminder.create", {
-        description: "创建一条提醒",
+        description: "⚠️ 仅写 DB，不主动推送（libero-mcp 无 background sender）。" +
+            "在 hermes 等有 cronjob 工具的平台上，用户要'X 时间提醒我 Y'请调宿主 cronjob（action=create, deliver=origin），不要用本工具。" +
+            "本工具仅用于：① 无 cron 能力的平台兜底；② 查询场景配合 getDue/getMissed。",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             content: z.string().min(1),
             remind_at: z.string().min(1),
             channel: z.string().optional(),
             timeblock_id: z.string().optional(),
         },
-    }, async (input) => asContent(await reminder.create(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await reminder.create(r));
+    });
     server.registerTool("reminder.getDue", {
         description: "获取到期且待发送的提醒列表",
         inputSchema: {
@@ -242,9 +402,14 @@ export function buildServer(db) {
     server.registerTool("reminder.getMissed", {
         description: "获取过期但未送达的提醒（被动补发用）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
         },
-    }, async ({ user_id }) => asContent(await reminder.getMissedReminders({ user_id })));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await reminder.getMissedReminders({ user_id: r.user_id }));
+    });
     server.registerTool("reminder.markSent", {
         description: "标记提醒为已发送（幂等）",
         inputSchema: { id: z.string().min(1) },
@@ -257,9 +422,15 @@ export function buildServer(db) {
     // scheduler (3 tools — S27, reuses timeblockRepo)
     // ============================================================
     server.registerTool("scheduler.createSchedule", {
-        description: "创建一个日程（planned 时间块）",
+        description: "创建一个日程（planned 时间块）。" +
+            "⚠️ MV-COACH-3 Slice 4 v2 教练闭环（用户主权模型）：建完 schedule 后，**必须**在同一回复里完成：" +
+            "① 调 cronjob(action=create, deliver=origin) 建开工 cron（schedule=日程开始时间），cron prompt 必须用 libero-coach skill 的'开工 cron 标准 prompt 模板'——**不允许自创结构**。" +
+            "② 那条标准 prompt 里写死了 3 步：推提醒 + 调 timeblock.update(status=**unverified**，不是 in_progress) + 建追问 cron（时间动态算：有耗时→过半；无耗时→+30min）。" +
+            "③ 顺带问用户'要不要每天 22:00 做个简短复盘？'（B 类推送必须先问再建）。" +
+            "关键：状态机用户主权——LLM 只能到点标 unverified 等用户核实，**不能擅自升级到 completed**。" +
+            "详见 libero-coach skill 的'推送抓手 + 状态机一条龙'段。",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             title: z.string().min(1),
             category_id: z.string().optional(),
             start_time: z.string(),
@@ -269,23 +440,40 @@ export function buildServer(db) {
             rating_reason: z.string().optional(),
             notes: z.string().optional(),
         },
-    }, async (input) => asContent(await scheduler.createSchedule(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await scheduler.createSchedule(r));
+    });
     server.registerTool("scheduler.listSchedules", {
-        description: "列出用户的日程（仅 planned 时间块）",
+        description: "内部工具：查询 planned 日程块用于排程冲突检查。" +
+            "⚠️ 用户「看今天/看日程/复盘/在干啥」请调 schedule.timeline（含矩阵+表格+全状态视图，不要调本工具）。" +
+            "本工具仅用于排程编排时的内部查询。",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             from: z.string().optional(),
             to: z.string().optional(),
         },
-    }, async (input) => asContent(await scheduler.listSchedules(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await scheduler.listSchedules(r));
+    });
     server.registerTool("scheduler.checkConflict", {
         description: "检查时间段是否与已有日程冲突",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             start_time: z.string(),
             end_time: z.string(),
         },
-    }, async (input) => asContent(await scheduler.checkConflict(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await scheduler.checkConflict(r));
+    });
     // ============================================================
     // task (7 tools — S29 P2-3 + 事一 draft/commit, takes raw db)
     // ============================================================
@@ -296,12 +484,18 @@ export function buildServer(db) {
         // 底层 createTask 仍保留 parent_id 能力（task.test.ts 单测不破）。
         inputSchema: z
             .object({
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             title: z.string().min(1),
             est_minutes: z.number().optional(),
         })
             .strict(),
-    }, async (input) => asContent(await task.createTask(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await task.createTask(r));
+    });
     server.registerTool("task.get", {
         description: "按 id 获取任务（含递归子树）",
         inputSchema: { id: z.string().min(1) },
@@ -309,10 +503,16 @@ export function buildServer(db) {
     server.registerTool("task.list", {
         description: "列出任务（parent_id=null 仅根；给定则该父的子；省略则全部）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
+            target_user_id: z.string().min(1).optional(),
             parent_id: z.string().nullable().optional(),
         },
-    }, async (input) => asContent(await task.listTasks(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await task.listTasks(r));
+    });
     server.registerTool("task.update", {
         description: "更新任务（title/est_minutes/status；状态机校验非法流转）",
         inputSchema: {
@@ -332,10 +532,15 @@ export function buildServer(db) {
     server.registerTool("task.findPlan", {
         description: "按事件名 exact-match 查拆解计划：返回根任务 + 第一块未完成子任务（record 开工时链 task_id，驱动闭环正反馈）",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             title: z.string().min(1),
         },
-    }, async (input) => asContent(await task.findPlan(input)));
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        return asContent(await task.findPlan(r));
+    });
     // S33 v3: task.draftPlan / task.commitPlan 从 MCP 工具列表移除（不再暴露给 mimo）。
     // 拆解唯一入口 = decompose.split（见下方 decompose 段）。
     // 底层 draftPlan/commitPlan 方法保留在 mcp/src/task/index.ts（被 decompose.split 复用 + task.test.ts 单测覆盖）。
@@ -347,7 +552,7 @@ export function buildServer(db) {
     server.registerTool("decompose.split", {
         description: "拆解 timeblock 为结构化子任务树（拆解唯一入口）。第一次调用出方案（不写库），第二次带 confirm_token 落地。状态机强制 draft→confirm→commit。⚠️ 拆子任务请用本工具，不要用 task.create。",
         inputSchema: {
-            user_id: z.string().min(1),
+            user_id: z.string().optional(),
             timeblock_id: z.string().min(1),
             children: z
                 .array(z.object({
@@ -357,8 +562,11 @@ export function buildServer(db) {
                 .min(1),
             confirm_token: z.string().optional(),
         },
-    }, async (input) => {
-        const result = await task.splitDecompose(input);
+    }, async (rawInput) => {
+        const r = injector(rawInput);
+        if ("error" in r)
+            return errorContent(r.error);
+        const result = await task.splitDecompose(r);
         // DecomposeErrorResult → isError content（不 throw，避 hermes 熔断器）
         if ("ok" in result && result.ok === false) {
             return {

package/dist/mcp/src/profile/confirm-default.js

@@ -0,0 +1,48 @@
+export function createProfileConfirmTools(db) {
+    return {
+        async confirmDefault(input) {
+            if (!input.platform_user_id || !input.platform_user_id.trim()) {
+                throw new Error("platform_user_id 为必填参数");
+            }
+            if (!input.display_name || !input.display_name.trim()) {
+                throw new Error("display_name 为必填参数");
+            }
+            const displayName = input.display_name.trim();
+            const platformUserId = input.platform_user_id.trim();
+            const taken = db
+                .prepare(`SELECT id FROM user_profile
+           WHERE display_name = ? AND id != ? AND deleted_at IS NULL`)
+                .get(displayName, platformUserId);
+            if (taken) {
+                return { status: "rejected", reason: "display_name_taken" };
+            }
+            const now = new Date().toISOString().replace("T", " ").replace("Z", "");
+            const existing = db
+                .prepare(`SELECT id FROM user_profile WHERE id = ? AND deleted_at IS NULL`)
+                .get(platformUserId);
+            if (existing) {
+                db.prepare(`UPDATE user_profile
+           SET display_name = ?, default_confirmed_at = ?, updated_at = ?
+           WHERE id = ?`).run(displayName, now, now, platformUserId);
+            }
+            else {
+                db.prepare(`INSERT INTO user_profile
+             (id, display_name, expectations, settings, default_confirmed_at, created_at, updated_at)
+           VALUES (?, ?, NULL, NULL, ?, ?, ?)`).run(platformUserId, displayName, now, now, now);
+            }
+            const row = db
+                .prepare(`SELECT id, display_name, expectations, settings, default_confirmed_at, created_at, updated_at
+           FROM user_profile WHERE id = ?`)
+                .get(platformUserId);
+            return {
+                id: row.id,
+                display_name: row.display_name,
+                default_confirmed_at: row.default_confirmed_at,
+                expectations: row.expectations,
+                settings: row.settings != null ? JSON.parse(row.settings) : null,
+                created_at: row.created_at,
+                updated_at: row.updated_at,
+            };
+        },
+    };
+}