libero3 0.3.0

package/dist/knowledge/time/time-forced-whitespace.yaml

@@ -0,0 +1,22 @@
+id: time-forced-whitespace
+kind: prescription
+dimension: time
+title: 强制留白
+triggers:
+  signals:
+    - daily_total_minutes: ">600"
+  symptoms:
+    - 某天经常过载
+    - 日程太满
+prescription:
+  one_liner: 日程只排 60-70%，把留白当作系统必需而非懒惰
+  steps:
+    - 计算你一天的实际可用时间
+    - 只排 60-70% 的任务
+    - 留出 30-40% 应对意外和恢复
+  micro_experiment: 明天日程只排 60%，留白 40%
+  verify: 一周后看过载天数是否减少
+source:
+  ref: Make Time (Jake Knapp & John Zeratsky)
+evidence_level: book
+tags: [留白, 日程]

package/dist/knowledge/time/time-gtd-next-action.yaml

@@ -0,0 +1,22 @@
+id: time-gtd-next-action
+kind: prescription
+dimension: time
+title: GTD 下一步物理动作
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 任务反复推迟
+    - 不知道从哪开始
+prescription:
+  one_liner: 把模糊目标拆为"打开文档 + 写 3 个小标题"级粒度
+  steps:
+    - 写下模糊目标
+    - 问自己"下一步物理动作是什么"
+    - 拆到 ≤5 分钟的粒度
+  micro_experiment: 选一个反复推迟的任务，拆成 3 个 ≤5 分钟的物理动作
+  verify: 拆解后 24 小时内是否启动了
+source:
+  ref: GTD (Getting Things Done, David Allen)
+evidence_level: framework
+tags: [GTD, 任务拆解]

package/dist/knowledge/time/time-three-tier-list.yaml

@@ -0,0 +1,22 @@
+id: time-three-tier-list
+kind: prescription
+dimension: time
+title: 三层专注清单
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 待办过载焦虑
+    - 事情太多
+prescription:
+  one_liner: 第一层今日重点 / 第二层本周推进 / 第三层随时杂事
+  steps:
+    - 列出所有待办
+    - 分三层：今日重点 ≤3 项 / 本周推进 / 随时杂事
+    - 每天先做第一层
+  micro_experiment: 明天只设 3 个今日重点，其他待办归入第二、三层
+  verify: 当天完成率是否提升
+source:
+  ref: Esor 时间管理方法论
+evidence_level: folk
+tags: [优先级, 清单]

package/dist/mcp/cold-start.js

@@ -0,0 +1,43 @@
+/**
+ * Cold-start copy for host agents (Hermes / OpenClaw) and MCP server instructions.
+ *
+ * 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，帮你管时间和精力。
+
+常用这几件事，直接说就行：
+• 计时：「开始计时写代码」/「开个 25 分钟番茄钟」
+• 日程：「明天 9 点到 11 点写报告」
+• 拆任务：「这个太大了，帮我拆一下」
+• 看数据：「这周时间都花哪儿了」
+• 复盘：「帮我复盘一下这周」
+
+想先试哪一句？`;
+/**
+ * MCP initialize `instructions` — injected into host model context after connect.
+ * Also documents the install sequence for hosts that read package docs.
+ */
+export function buildServerInstructions() {
+    return [
+        "# libero — 时间与精力管理助手",
+        "",
+        "## 装机（对 host agent，不是对用户）",
+        "用户只说「帮我装 libero」或跑 npm i -g。**禁止**让用户再提醒你读 md / 执行命令。",
+        "npm postinstall 会打印 LIBERO_HOST_ACTION + 欢迎原文：你的**下一条对用户回复**必须是该欢迎，然后再 /reload-mcp。",
+        "禁止问 user_id；禁止列工具表。",
+        "",
+        "## 冷启动欢迎（原样发给用户）",
+        COLD_START_WELCOME,
+        "",
+        "## user_id（硬纪律）",
+        "- 从当前会话上下文静默取；取不到用 local:default",
+        "- **禁止问用户起 user_id**；禁止 wechat_你的ID / test_1 问卷",
+        "",
+        "## 对用户说话",
+        "- 只说自然语言能做什么；不要提 MCP / 工具表 / schema / 数据库",
+        "- 用户选了试用例句 → 直接执行，不要重复整段介绍",
+    ].join("\n");
+}

package/dist/mcp/contract/v1/rest.js

@@ -0,0 +1,56 @@
+/**
+ * MC-0b REST contract v1 — single source of truth (api-contract-first).
+ *
+ * REST adapter and tests bind these schemas. Do not invent parallel field names.
+ */
+import { z } from "zod";
+export const restErrorCodeSchema = z.enum([
+    "unauthorized",
+    "forbidden",
+    "not_found",
+    "invalid_input",
+    "tool_error",
+    "internal",
+    "unavailable",
+    "llm_error",
+]);
+export const restErrorBodySchema = z.object({
+    ok: z.literal(false),
+    error: z.object({
+        code: restErrorCodeSchema,
+        message: z.string().min(1),
+    }),
+});
+export const restSuccessBodySchema = z.object({
+    ok: z.literal(true),
+    data: z.unknown(),
+});
+export const restHealthBodySchema = z.object({
+    ok: z.literal(true),
+});
+export const chatRequestBodySchema = z.object({
+    message: z.string().min(1),
+});
+export const chatSuccessBodySchema = z.object({
+    ok: z.literal(true),
+    reply: z.string().min(1),
+    tools_called: z.array(z.string()),
+});
+/** INT-AP-tools — request/response data (fields bind to libero-homm spec). */
+export const apCreditDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+    credited: z.number().int().positive(),
+    source: z.string().min(1),
+});
+export const apBalanceDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+});
+export const apSpendDataSchema = z.object({
+    balance: z.number().int().nonnegative(),
+    spent: z.number().int().positive(),
+});
+export const REST_V1 = {
+    health: { method: "GET", path: "/api/v1/health" },
+    invokeTool: { method: "POST", path: "/api/v1/tools/:toolName" },
+    chat: { method: "POST", path: "/api/v1/chat" },
+};

package/dist/mcp/rest-server.js

@@ -0,0 +1,52 @@
+#!/usr/bin/env node
+/**
+ * libero REST server — HTTP adapter over the same tool registry (MC-0b).
+ *
+ * Usage:
+ *   LIBERO_REST_TOKENS='{"<token>":"<libero_user_id>"}' libero-rest
+ *   DB_PATH=/path/to/libero.db LIBERO_REST_PORT=8787 libero-rest
+ *
+ * Default bind 127.0.0.1 (local trial). Same DB_PATH as MCP → same ledger.
+ */
+import { serve } from "@hono/node-server";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { initDb, closeDb } from "../data/db.js";
+import { createToolRuntime } from "./server-core.js";
+import { createRestApp } from "./src/rest/app.js";
+import { parseRestTokens } from "./src/rest/tokens.js";
+import { chatLlmFromEnv } from "./src/chat/from-env.js";
+const DB_PATH = process.env.DB_PATH ?? join(homedir(), ".libero", "libero.db");
+const PORT = Number(process.env.LIBERO_REST_PORT ?? "8787");
+const HOST = process.env.LIBERO_REST_HOST ?? "127.0.0.1";
+let tokenMap;
+try {
+    tokenMap = parseRestTokens(process.env);
+}
+catch (e) {
+    console.error(`[libero-rest] FATAL: ${e.message}`);
+    process.exit(1);
+}
+const db = initDb(DB_PATH);
+console.error(`[libero-rest] DB initialized at ${DB_PATH}`);
+const { registry } = createToolRuntime(db);
+const chatLlm = chatLlmFromEnv(process.env);
+if (!chatLlm) {
+    console.error("[libero-rest] chat disabled: set LIBERO_CHAT_BASE_URL, LIBERO_CHAT_API_KEY, LIBERO_CHAT_MODEL");
+}
+const linkSecret = process.env.LIBERO_LINK_TOKEN_SECRET?.trim() || undefined;
+const linkBaseUrl = process.env.LIBERO_HOMM_LINK_BASE?.trim() || undefined;
+const ttlSec = process.env.LIBERO_LINK_TOKEN_TTL_SEC ? Number(process.env.LIBERO_LINK_TOKEN_TTL_SEC) : undefined;
+if (!linkSecret)
+    console.warn("[libero-rest] LIBERO_LINK_TOKEN_SECRET 未配置：homm 链接回退 tk_main（无逐用户短 token）");
+const app = createRestApp({ registry, tokenMap, chatLlm: chatLlm ?? undefined, linkSecret, linkBaseUrl, ttlSec });
+serve({ fetch: app.fetch, port: PORT, hostname: HOST }, (info) => {
+    console.error(`[libero-rest] listening on http://${info.address}:${info.port}`);
+});
+function shutdown() {
+    console.error("[libero-rest] Shutting down…");
+    closeDb();
+    process.exit(0);
+}
+process.on("SIGINT", shutdown);
+process.on("SIGTERM", shutdown);