libero-mcp 0.2.14 → 0.2.16

package/dist/mcp/server-core.js

@@ -301,6 +301,34 @@ function buildToolRegistry(ctx) {
             return asContent(await tb.list(r));
         },
     });
+    tools.push({
+        name: "timeblock.sweepStale",
+        description: "S43 过期扫描：列出某用户当天过期未确认的 timeblock，分两组返回。" +
+            "to_unverified：end_time 已过 30min 仍 planned（该升级 unverified）。" +
+            "to_ask：end_time 已过 60min 仍 unverified/planned（该主动问用户）。" +
+            "⚠️ 纯查询，不改 db——caller（cron-session LLM）需对 to_unverified 显式调 timeblock.update(status=unverified)，对 to_ask 调 cronjob create 发追问。" +
+            "⚠️ 仅 cron-session 调用；user_id 必填。",
+        inputSchema: {
+            user_id: z.string().min(1),
+            now: z.string().optional(),
+            overdue_min_to_unverified: z.number().optional(),
+            overdue_min_to_ask: z.number().optional(),
+        },
+        handler: async (rawInput) => {
+            try {
+                const result = await tb.sweepStale({
+                    user_id: rawInput.user_id,
+                    now: rawInput.now,
+                    overdue_min_to_unverified: rawInput.overdue_min_to_unverified,
+                    overdue_min_to_ask: rawInput.overdue_min_to_ask,
+                });
+                return asContent(result);
+            }
+            catch (e) {
+                return errorContent(e.message);
+            }
+        },
+    });
     // ============================================================
     // stats (2 tools — single-object filters)
     // ============================================================
@@ -345,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(),
@@ -365,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(),
@@ -600,6 +630,22 @@ function buildToolRegistry(ctx) {
             }
         },
     });
+    tools.push({
+        name: "profile.listAllUsers",
+        description: "S43 多用户扫描：列出所有 libero 用户（libero_user_id + display_name）。" +
+            "用途：cron 扫描（每 30min）跑所有用户的状态升级和主动询问，不靠 LLM 从上下文猜。" +
+            "⚠️ 仅 cron-session 调用，普通对话不要用。",
+        inputSchema: {},
+        handler: async () => {
+            try {
+                const result = await profile.listAllUsers();
+                return asContent({ users: result });
+            }
+            catch (e) {
+                return errorContent(e.message);
+            }
+        },
+    });
     // ============================================================
     // reminder (6 tools — S11)
     // ============================================================

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

@@ -59,4 +59,7 @@ export class InMemoryIdentityRepo {
         }
         return null;
     }
+    async listAllIdentities() {
+        return Array.from(this.identities.values());
+    }
 }

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

@@ -171,5 +171,22 @@ export function createProfileTools(repo, identityRepo) {
                 bound_alias,
             };
         },
+        /**
+         * S43（2026-08-07）：列出所有 libero 用户。
+         * 用途：扫描 cron 跑所有用户的状态升级和主动询问（不靠 LLM 从上下文猜）。
+         *
+         * 数据源：identity 表（libero 内部身份）。display_name 取 identity 表的。
+         * §4.5 静默折叠声明：返回所有 identity 行；若 identityRepo 未注入则抛（不静默返回空）。
+         */
+        async listAllUsers() {
+            if (!identityRepo) {
+                throw new Error("listAllUsers 需要 identityRepo（server-core 启动时未注入，本部署不支持多用户扫描）");
+            }
+            const identities = await identityRepo.listAllIdentities();
+            return identities.map((i) => ({
+                libero_user_id: i.libero_user_id,
+                display_name: i.display_name,
+            }));
+        },
     };
 }

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

@@ -76,4 +76,12 @@ export class SqliteIdentityRepo {
             .get(platform_user_id);
         return row ? { ...row } : null;
     }
+    async listAllIdentities() {
+        const rows = this.db
+            .prepare(`SELECT libero_user_id, display_name, created_at, updated_at
+         FROM user_identity
+         ORDER BY created_at ASC`)
+            .all();
+        return rows.map((r) => ({ ...r }));
+    }
 }

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

@@ -117,5 +117,67 @@ export function createTimeBlockTools(repo, db) {
         async restore(id) {
             return repo.restore(id);
         },
+        /**
+         * S43（2026-08-07）：扫描某用户过期未确认的 timeblock，分组返回。
+         *
+         * 用途：cron-session 每 30min 调一次，让 cron LLM 显式调 timeblock.update
+         * 升级状态 + 主动问。本工具**不**直接改 db（保留 brain/hand 分离 + 用户主权模型）。
+         *
+         * 判定逻辑（以 now 为基准）：
+         * - end_time + overdue_min_to_unverified (默认 30min) 仍 planned → to_unverified
+         * - end_time + overdue_min_to_ask (默认 60min) 仍 unverified/planned → to_ask
+         * - completed / 未过期 / 软删的 → 都不进
+         *
+         * §4.5 静默折叠声明：纯查询，无副作用，无折叠。
+         */
+        async sweepStale(input) {
+            if (!input.user_id) {
+                throw new Error("user_id 为必填参数");
+            }
+            const nowIso = input.now ?? new Date().toISOString();
+            const nowMs = new Date(nowIso).getTime();
+            const thresholdUnverifiedMin = input.overdue_min_to_unverified ?? 30;
+            const thresholdAskMin = input.overdue_min_to_ask ?? 60;
+            const thresholdUnverifiedMs = thresholdUnverifiedMin * 60 * 1000;
+            const thresholdAskMs = thresholdAskMin * 60 * 1000;
+            // 用 list 拿到该用户所有非软删的块（list 默认会过滤 deleted_at）
+            const blocks = await repo.list({
+                user_id: input.user_id,
+            });
+            const to_unverified = [];
+            const to_ask = [];
+            for (const b of blocks) {
+                if (b.deleted_at)
+                    continue;
+                if (b.status === "completed")
+                    continue;
+                const endMs = new Date(b.end_time).getTime();
+                if (Number.isNaN(endMs))
+                    continue;
+                const ageMs = nowMs - endMs;
+                if (ageMs <= 0)
+                    continue; // 还没到 end_time
+                const overdueUnverified = ageMs >= thresholdUnverifiedMs;
+                const overdueAsk = ageMs >= thresholdAskMs;
+                if (overdueUnverified && b.status === "planned") {
+                    to_unverified.push({
+                        id: b.id,
+                        title: b.title,
+                        start_time: b.start_time,
+                        end_time: b.end_time,
+                    });
+                }
+                if (overdueAsk && (b.status === "unverified" || b.status === "planned")) {
+                    to_ask.push({
+                        id: b.id,
+                        title: b.title,
+                        start_time: b.start_time,
+                        end_time: b.end_time,
+                        status: b.status,
+                    });
+                }
+            }
+            return { to_unverified, to_ask, now: nowIso };
+        },
     };
 }

package/package.json

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