libero3 0.3.0

package/knowledge/tests/repo/fs-yaml-knowledge-repo.test.ts

@@ -0,0 +1,333 @@
+import { describe, test, expect, beforeEach } from "vitest";
+import { writeFileSync, unlinkSync, rmSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { validateEntry } from "../../_schema/entry.schema.js";
+import { FsYamlKnowledgeRepo } from "../../src/repo/fs-yaml.js";
+
+// ── Fixture paths ──
+
+const FIXTURES_BASE = join(import.meta.dirname, "..", "fixtures");
+const BASE = join(FIXTURES_BASE, "base");
+const DUP = join(FIXTURES_BASE, "dup");
+const UNREGISTERED = join(FIXTURES_BASE, "unregistered");
+
+// ============================================================
+// Schema validation tests (T1-T6) — test validateEntry() directly
+// ============================================================
+
+describe("Schema validation (validateEntry)", () => {
+  // T1
+  test("T1: valid entry passes validation", () => {
+    const entry = validateEntry({
+      id: "test-valid",
+      kind: "prescription",
+      dimension: "time",
+      title: "测试条目",
+      triggers: {
+        signals: [{ quadrant: "能耗黑洞" }],
+        symptoms: ["测试症状"],
+      },
+      prescription: {
+        one_liner: "测试处方",
+        micro_experiment: "测试微实验",
+      },
+      source: { ref: "测试来源" },
+      evidence_level: "book",
+    });
+    expect(entry.id).toBe("test-valid");
+    expect(entry.kind).toBe("prescription");
+    expect(entry.dimension).toBe("time");
+    // Default values
+    expect(entry.tags).toEqual([]);
+    expect(entry.applicability.personas_fit).toEqual([]);
+  });
+
+  // T2
+  test("T2: missing id throws", () => {
+    expect(() =>
+      validateEntry({
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { symptoms: ["测试"] },
+        prescription: { one_liner: "t", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+  });
+
+  // T3
+  test("T3: empty triggers (no signals, no symptoms) throws", () => {
+    // Both fields absent
+    expect(() =>
+      validateEntry({
+        id: "t3",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: {},
+        prescription: { one_liner: "t", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+
+    // Both fields explicitly empty arrays
+    expect(() =>
+      validateEntry({
+        id: "t3b",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { signals: [], symptoms: [] },
+        prescription: { one_liner: "t", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+
+    // signals present but empty, symptoms absent
+    expect(() =>
+      validateEntry({
+        id: "t3c",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { signals: [] },
+        prescription: { one_liner: "t", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+  });
+
+  // T4
+  test("T4: kind=prescription without one_liner throws", () => {
+    // Missing one_liner field entirely
+    expect(() =>
+      validateEntry({
+        id: "t4",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { symptoms: ["测试"] },
+        prescription: { micro_experiment: "t" } as any,
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+
+    // Empty one_liner string
+    expect(() =>
+      validateEntry({
+        id: "t4b",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { symptoms: ["测试"] },
+        prescription: { one_liner: "", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+
+    // Missing micro_experiment
+    expect(() =>
+      validateEntry({
+        id: "t4c",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { symptoms: ["测试"] },
+        prescription: { one_liner: "t" },
+        source: { ref: "t" },
+        evidence_level: "book",
+      })
+    ).toThrow();
+  });
+
+  // T6
+  test("T6: invalid evidence_level throws", () => {
+    expect(() =>
+      validateEntry({
+        id: "t6",
+        kind: "prescription" as const,
+        dimension: "time",
+        title: "测试",
+        triggers: { symptoms: ["测试"] },
+        prescription: { one_liner: "t", micro_experiment: "t" },
+        source: { ref: "t" },
+        evidence_level: "unknown" as any,
+      })
+    ).toThrow();
+  });
+});
+
+// ============================================================
+// KnowledgeRepo checks — duplicate id & dimension registry (T5, T7)
+// ============================================================
+
+describe("KnowledgeRepo — validation at load time", () => {
+  // T5
+  test("T5: duplicate id in loadAll throws", async () => {
+    const repo = new FsYamlKnowledgeRepo(DUP);
+    await expect(repo.loadAll()).rejects.toThrow();
+  });
+
+  // T7
+  test("T7: unregistered dimension throws", async () => {
+    const repo = new FsYamlKnowledgeRepo(UNREGISTERED);
+    await expect(repo.loadAll()).rejects.toThrow(/维度|dimension/i);
+  });
+});
+
+// ============================================================
+// KnowledgeRepo — base fixture operations (T8-T12, T15, T16)
+// ============================================================
+
+describe("KnowledgeRepo — CRUD with base fixtures", () => {
+  let repo: FsYamlKnowledgeRepo;
+
+  beforeEach(() => {
+    // Create fresh instance each test
+    repo = new FsYamlKnowledgeRepo(BASE);
+  });
+
+  // T8
+  test("T8: loadAll returns correct count", async () => {
+    const entries = await repo.loadAll();
+    expect(entries.length).toBeGreaterThan(0);
+  });
+
+  // T9
+  test("T9: getById hits existing entry", async () => {
+    const entry = await repo.getById("test-valid-entry");
+    expect(entry).not.toBeNull();
+    expect(entry!.id).toBe("test-valid-entry");
+    expect(entry!.dimension).toBe("time");
+  });
+
+  // T10
+  test("T10: byDimension filters correctly", async () => {
+    const time = await repo.byDimension("time");
+    expect(time.length).toBeGreaterThan(0);
+    for (const e of time) {
+      expect(e.dimension).toBe("time");
+    }
+  });
+
+  // T11
+  test("T11: matchBySignal quadrant match returns entries", async () => {
+    const matches = await repo.matchBySignal({ quadrant: "能耗黑洞" });
+    expect(matches.length).toBeGreaterThan(0);
+    for (const e of matches) {
+      const hasQuadrant = (e.triggers.signals ?? []).some(
+        (s) => s.quadrant === "能耗黑洞"
+      );
+      expect(hasQuadrant).toBe(true);
+    }
+  });
+
+  // T12
+  test("T12: matchBySymptom returns matching entries", async () => {
+    const matches = await repo.matchBySymptom("拖延");
+    expect(matches.length).toBeGreaterThan(0);
+    for (const e of matches) {
+      const hasSymptom = (e.triggers.symptoms ?? []).some((s) =>
+        s.includes("拖延")
+      );
+      expect(hasSymptom).toBe(true);
+    }
+  });
+
+  // T15
+  test("T15: getById nonexistent returns null", async () => {
+    const entry = await repo.getById("nonexistent-id");
+    expect(entry).toBeNull();
+  });
+
+  // T16
+  test("T16: byDimension empty dimension returns empty array", async () => {
+    const entries = await repo.byDimension("nonexistent-dim");
+    expect(entries).toHaveLength(0);
+  });
+});
+
+// ============================================================
+// Equivalence test — real knowledge dir (T13)
+// ============================================================
+
+describe("Equivalence — real knowledge directory preserves migrated content", () => {
+  // T13: 迁移等价性。初始迁移 21 条；断言下界而非精确数——
+  // 知识库可扩展（如番茄钟/论文），硬编码精确数会反扩展性。
+  // 守住"不少于初始迁移"即满足"不丢内容"的本意。
+  test("T13: loadAll from real knowledge dir returns ≥ 21 entries (initial migration baseline)", async () => {
+    const repo = new FsYamlKnowledgeRepo();
+    const entries = await repo.loadAll();
+    expect(entries.length).toBeGreaterThanOrEqual(21);
+  });
+});
+
+// ============================================================
+// Extensibility test (T14)
+// ============================================================
+
+describe("Extensibility — new dimension via file addition", () => {
+  // T14
+  test("T14: adding a new dimension + entry works without code changes", async () => {
+    const tmpDir = join(FIXTURES_BASE, "__ext_test__");
+    const regDir = join(tmpDir, "_registry");
+    const anxDir = join(tmpDir, "anxiety");
+
+    try {
+      mkdirSync(regDir, { recursive: true });
+      mkdirSync(anxDir, { recursive: true });
+
+      // Create registry with the new dimension
+      writeFileSync(
+        join(regDir, "dimensions.yaml"),
+        [
+          "dimensions:",
+          '  - id: time',
+          '    label: 时间',
+          '    proposition: test',
+          '  - id: anxiety',
+          '    label: 焦虑',
+          '    proposition: test',
+        ].join("\n"),
+        "utf-8"
+      );
+
+      // Create a valid entry in the new dimension
+      writeFileSync(
+        join(anxDir, "parasympathetic.yaml"),
+        [
+          'id: anxiety-parasympathetic',
+          'kind: prescription',
+          'dimension: anxiety',
+          'title: 副交感神经激活',
+          'triggers:',
+          '  symptoms:',
+          '    - 焦虑',
+          'prescription:',
+          '  one_liner: 测试条目',
+          '  micro_experiment: 测试',
+          'source:',
+          '  ref: 测试',
+          'evidence_level: book',
+        ].join("\n"),
+        "utf-8"
+      );
+
+      const repo = new FsYamlKnowledgeRepo(tmpDir);
+      const entries = await repo.loadAll();
+      expect(entries).toHaveLength(1);
+      expect(entries[0].dimension).toBe("anxiety");
+      expect(entries[0].id).toBe("anxiety-parasympathetic");
+    } finally {
+      // Cleanup
+      rmSync(tmpDir, { recursive: true, force: true });
+    }
+  });
+});

package/knowledge/time/time-batch-windows.yaml

@@ -0,0 +1,22 @@
+id: time-batch-windows
+kind: prescription
+dimension: time
+title: 窗口期批处理
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 浅薄工作占比大
+    - 消息太多
+prescription:
+  one_liner: 邮件/消息每天只在固定 2 个时段处理，其余时间默认不可达
+  steps:
+    - 选定 2 个批处理时段（如 11:00 和 16:00）
+    - 批处理时段集中回邮件/消息
+    - 其余时间关闭通知
+  micro_experiment: 明天只在 11:00 和 16:00 各花 15 分钟处理消息
+  verify: 一天中被消息打断的次数是否显著下降
+source:
+  ref: 《深度工作》(Deep Work, Cal Newport)
+evidence_level: book
+tags: [批处理, 消息管理]

package/knowledge/time/time-conscious-abandon.yaml

@@ -0,0 +1,22 @@
+id: time-conscious-abandon
+kind: prescription
+dimension: time
+title: 有意识的放弃
+triggers:
+  signals:
+    - quadrant: 可放弃
+  symptoms:
+    - 可放弃事项多
+    - 做减法
+prescription:
+  one_liner: 选一个低分分类，直接砍掉或砍半。空出来的时间不填新东西——感受"留白"
+  steps:
+    - 找出可放弃象限中耗时最长但满意度最低的 1 个分类
+    - 直接砍掉或砍半
+    - 空出来的时间不填新东西
+  micro_experiment: 选一个低分分类砍掉，空出来的时间不填新东西
+  verify: 一周后看总耗时是否下降、满意度是否提升
+source:
+  ref: 《四千周》(Four Thousand Weeks, Oliver Burkeman)
+evidence_level: book
+tags: [做减法, 放弃]

package/knowledge/time/time-deep-work-block.yaml

@@ -0,0 +1,22 @@
+id: time-deep-work-block
+kind: prescription
+dimension: time
+title: 深度工作块
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 碎片化严重
+    - 频繁切换
+prescription:
+  one_liner: 每天锁定 1-1.5 小时无干扰深度时段：关通知、手机放抽屉、只做一件事
+  steps:
+    - 选定每天的深度时段（如上午 9:00-10:30）
+    - 关掉所有通知，手机放抽屉
+    - 只做一件需要深度思考的事
+  micro_experiment: 明天上午锁定 90 分钟无干扰深度工作，关通知+手机放抽屉
+  verify: 深度工作块后的产出感和满意度
+source:
+  ref: 《深度工作》(Deep Work, Cal Newport)
+evidence_level: book
+tags: [专注, 深度工作]

package/knowledge/time/time-finite-commitment.yaml

@@ -0,0 +1,22 @@
+id: time-finite-commitment
+kind: prescription
+dimension: time
+title: 有限承诺清单
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 承诺过多
+    - 焦虑忙乱
+prescription:
+  one_liner: 列出 3-5 个核心承诺，新任务进入前必须先挤掉一个旧的
+  steps:
+    - 写下当前所有在进行的承诺
+    - 只保留最重要的 3-5 个为"核心承诺层"
+    - 任何新任务进入，必须先从核心层挤掉一个
+  micro_experiment: 本周把活跃承诺压到 ≤5 个，新任务来必须先删一个旧的
+  verify: 一周后看高投入低满足分类的耗时是否下降
+source:
+  ref: 《四千周》(Four Thousand Weeks, Oliver Burkeman)
+evidence_level: book
+tags: [做减法, 承诺管理]

package/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/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/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/knowledge/validate.ts

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+import { FsYamlKnowledgeRepo } from "./src/repo/fs-yaml.js";
+
+async function main() {
+  const repo = new FsYamlKnowledgeRepo();
+  try {
+    const entries = await repo.loadAll();
+    console.log(`✅ ${entries.length} 条知识条目校验通过`);
+    // dimension breakdown
+    const dims = new Map<string, number>();
+    for (const e of entries) dims.set(e.dimension, (dims.get(e.dimension) || 0) + 1);
+    for (const [dim, count] of dims) console.log(`   ${dim}: ${count} 条`);
+
+    // COACH-MOD §3：复盘模块知识层校验（schema + 引用完整性）
+    const models = await repo.loadAnalysisModels();
+    const packs = await repo.loadScenarioPacks();
+    const personas = await repo.loadPersonas();
+
+    // 恰好一个默认模型（getDefaultAnalysisModel 内含 0/多 抛错）
+    const defaultModel = await repo.getDefaultAnalysisModel();
+
+    // 场景包引用完整性：persona_id + analysis_model_ids 必须存在
+    const modelIds = new Set(models.map((m) => m.id));
+    const personaIds = new Set(personas.map((p) => p.id));
+    for (const pack of packs) {
+      if (!personaIds.has(pack.recommends.persona_id)) {
+        throw new Error(
+          `场景包 "${pack.id}" 引用的画像 "${pack.recommends.persona_id}" 不存在`,
+        );
+      }
+      for (const mid of pack.recommends.analysis_model_ids) {
+        if (!modelIds.has(mid)) {
+          throw new Error(
+            `场景包 "${pack.id}" 引用的分析模型 "${mid}" 不存在`,
+          );
+        }
+      }
+    }
+
+    console.log(
+      `✅ 复盘模块：${models.length} 分析模型（默认=${defaultModel.id}）/ ${packs.length} 场景包 / ${personas.length} 画像，引用完整`,
+    );
+    process.exit(0);
+  } catch (e: any) {
+    console.error(`❌ 校验失败: ${e.message}`);
+    process.exit(1);
+  }
+}
+
+main();

package/package.json

@@ -0,0 +1,76 @@
+{
+  "name": "libero3",
+  "version": "0.3.0",
+  "description": "AI 时间管理教练 MCP 工具集——时间块记录、统计、矩阵诊断、计时、分类、profile",
+  "license": "MIT",
+  "author": "amosyuan",
+  "homepage": "https://github.com/beimingju-dafu/libero-2",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/beimingju-dafu/libero-2.git"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "time-tracking",
+    "productivity",
+    "coach",
+    "ai"
+  ],
+  "type": "module",
+  "packageManager": "pnpm@9.15.9",
+  "bin": {
+    "libero-mcp": "./dist/mcp/server.js",
+    "libero-rest": "./dist/mcp/rest-server.js",
+    "libero3": "./dist/mcp/server.js"
+  },
+  "scripts": {
+    "start:rest": "tsx mcp/rest-server.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "db:init": "tsx data/db.ts",
+    "build": "tsc -p tsconfig.build.json && cp -r data/migrations dist/data/ && cp data/schema.sql dist/data/ && find knowledge -name '*.yaml' -not -path '*/tests/*' -exec sh -c 'mkdir -p dist/knowledge/$(dirname \"${1#knowledge/}\") && cp \"$1\" dist/knowledge/\"${1#knowledge/}\"' _ {} \\;",
+    "postinstall": "node scripts/postinstall-cold-start.js",
+    "prepublishOnly": "npm test && npm run build",
+    "knowledge:validate": "tsx knowledge/validate.ts",
+    "case:panel": "tsx eval/case-panel/server.ts",
+    "eval:smoke": "tsx eval/auto-runner.ts --smoke --runs 3",
+    "eval:smoke:deterministic": "tsx eval/run-smoke-deterministic.ts",
+    "prepare": "husky"
+  },
+  "files": [
+    "dist",
+    "data/migrations",
+    "data/schema.sql",
+    "knowledge",
+    "COLD_START.md",
+    "scripts/postinstall-cold-start.js"
+  ],
+  "dependencies": {
+    "@hono/node-server": "^2.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "better-sqlite3": "^12.10.0",
+    "hono": "^4.13.1",
+    "js-yaml": "^4.2.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/js-yaml": "^4.0.9",
+    "@types/node": "^20.0.0",
+    "cron-parser": "^5.6.2",
+    "eslint": "^10.6.0",
+    "eslint-config-prettier": "^10.1.8",
+    "husky": "^9.1.7",
+    "prettier": "^3.9.4",
+    "tsx": "^4.0.0",
+    "typescript": "^5.4.0",
+    "typescript-eslint": "^8.62.1",
+    "vitest": "^1.6.0"
+  }
+}

package/scripts/postinstall-cold-start.js

@@ -0,0 +1,45 @@
+#!/usr/bin/env node
+/**
+ * postinstall — print cold-start for the *installing host agent* (Hermes/OpenClaw).
+ * End users never need to remember this; the host must relay the welcome as its
+ * next chat message, then reload MCP. Do not ask the human to coach the agent.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = join(dirname(fileURLToPath(import.meta.url)), "..");
+const welcomePath = join(root, "COLD_START.md");
+
+const FALLBACK_WELCOME = `你好，我是 libero，帮你管时间和精力。
+
+常用这几件事，直接说就行：
+• 计时：「开始计时写代码」/「开个 25 分钟番茄钟」
+• 日程：「明天 9 点到 11 点写报告」
+• 拆任务：「这个太大了，帮我拆一下」
+• 看数据：「这周时间都花哪儿了」
+• 复盘：「帮我复盘一下这周」
+
+想先试哪一句？`;
+
+function extractWelcome(md) {
+  const m = md.match(/```\n([\s\S]*?)\n```/);
+  return m ? m[1].trim() : FALLBACK_WELCOME;
+}
+
+const welcome = existsSync(welcomePath)
+  ? extractWelcome(readFileSync(welcomePath, "utf-8"))
+  : FALLBACK_WELCOME;
+
+// Markers are for the installing agent reading npm output — never for the human checklist.
+process.stderr.write(`
+========== LIBERO_HOST_ACTION (installing agent only) ==========
+Your NEXT message to the human MUST be the welcome block below (verbatim).
+Do NOT ask for user_id. Do NOT list MCP tools / schemas.
+THEN configure mcp_servers.libero (command: libero-mcp) if needed and /reload-mcp.
+The human must NOT be told to "read a md" or "remind the agent".
+---------- welcome (send to human) ----------
+${welcome}
+---------- end welcome ----------
+===============================================================
+`);