libero3 0.3.0

package/knowledge/energy/energy-exercise-embedded.yaml

@@ -0,0 +1,22 @@
+id: energy-exercise-embedded
+kind: prescription
+dimension: energy
+title: 运动嵌入日程
+triggers:
+  signals:
+    - quadrant: 可放弃
+  symptoms:
+    - 运动缺失
+    - 精力不足
+prescription:
+  one_liner: 从频率开始而非强度：每周固定 3 次，每次 20 分钟快走即可
+  steps:
+    - 选定每周 3 个固定时间
+    - 每次 20 分钟快走（不追求强度）
+    - 只关注"是否做了"不关注"做得多好"
+  micro_experiment: 本周固定 3 次 20 分钟快走
+  verify: 运动后精力感知是否改善
+source:
+  ref: 《运动改造大脑》(Spark, John Ratey)
+evidence_level: book
+tags: [运动, 精力]

package/knowledge/energy/energy-fixed-wake-time.yaml

@@ -0,0 +1,22 @@
+id: energy-fixed-wake-time
+kind: prescription
+dimension: energy
+title: 先固化起床时间
+triggers:
+  signals:
+    - quadrant: 可放弃
+  symptoms:
+    - 睡眠缺失
+    - 作息混乱
+prescription:
+  one_liner: 连续两周固定起床时间（如 7:00），起床后立刻接触自然光 5 分钟；睡前一小时断屏
+  steps:
+    - 选定一个起床时间（如 7:00）
+    - 起床后立刻接触自然光 5 分钟
+    - 睡前一小时断屏
+  micro_experiment: 连续两周固定 7:00 起床+起床后自然光 5 分钟
+  verify: 两周后入睡时间和睡眠质量的变化
+source:
+  ref: 《为什么我们要睡觉》(Why We Sleep, Matthew Walker)
+evidence_level: book
+tags: [睡眠, 节律]

package/knowledge/energy/energy-four-energy-radar.yaml

@@ -0,0 +1,22 @@
+id: energy-four-energy-radar
+kind: prescription
+dimension: energy
+title: 四类精力雷达图
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 整体评分趋势下降
+    - 倦怠
+prescription:
+  one_liner: 身体/情绪/心智/意义各打分 1-10，找最低维度先修
+  steps:
+    - 给身体/情绪/心智/意义各打 1-10 分
+    - 找出最低维度
+    - 针对最低维度选一条处方
+  micro_experiment: 今晚给四类精力各打分，找出最低维度
+  verify: 一周后重新打分看是否改善
+source:
+  ref: 《精力管理》(The Power of Full Engagement, Jim Loehr & Tony Schwartz)
+evidence_level: book
+tags: [精力管理, 自评]

package/knowledge/energy/energy-intensity-recovery.yaml

@@ -0,0 +1,22 @@
+id: energy-intensity-recovery
+kind: prescription
+dimension: energy
+title: 强度+恢复交替
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 连续高强度无恢复
+    - 精力透支
+prescription:
+  one_liner: 高强度 1-1.5 小时后强制物理走动 5-10 分钟
+  steps:
+    - 设定 60-90 分钟高强度工作块
+    - 时间到强制起身物理走动 5-10 分钟
+    - 循环
+  micro_experiment: 明天每工作 90 分钟后强制走动 5 分钟
+  verify: 一天结束时的疲惫感是否低于平时
+source:
+  ref: Peak Performance (Brad Stulberg & Steve Magness)
+evidence_level: book
+tags: [恢复, 节奏]

package/knowledge/scenario-packs/pack-summer-kid.yaml

@@ -0,0 +1,12 @@
+id: pack-summer-kid
+kind: scenario-pack
+title: 暑期计划（小学生）
+triggers:
+  context_tags: [小学生, 暑假, 帮孩子, 暑期, 孩子]
+recommends:
+  persona_id: kid-primary-school
+  analysis_model_ids: [review-summer-plan]
+  subskill_prompt: |
+    对象是小学生 + 家长协作：语言更具体、目标更小、
+    强调玩与学平衡、尊重孩子自主，不把家长焦虑转嫁孩子。
+description: 家长帮小学生规划/复盘暑假的情境包

package/knowledge/src/repo/fs-yaml.ts

@@ -0,0 +1,282 @@
+import { readFileSync, readdirSync, existsSync, statSync } from "node:fs";
+import { join, dirname, extname, relative } from "node:path";
+import { fileURLToPath } from "node:url";
+import yaml from "js-yaml";
+import type { KnowledgeEntry } from "../../_schema/entry.schema.js";
+import { validateEntry } from "../../_schema/entry.schema.js";
+import type { AnalysisModel } from "../../_schema/analysis-model.schema.js";
+import { validateAnalysisModel } from "../../_schema/analysis-model.schema.js";
+import type { ScenarioPack } from "../../_schema/scenario-pack.schema.js";
+import { validateScenarioPack } from "../../_schema/scenario-pack.schema.js";
+import type { Persona } from "../../_schema/persona.schema.js";
+import { validatePersonaRegistry } from "../../_schema/persona.schema.js";
+import type { TriggerSignal } from "./types.js";
+
+/** Repository root dir (two levels up from knowledge/src/repo/ → knowledge/) */
+function defaultBasePath(): string {
+  // When running via tsx, import.meta.dirname is the dir of this file
+  return join(import.meta.dirname, "..", "..");
+}
+
+interface DimensionRegistry {
+  dimensions: Array<{ id: string; label: string; proposition: string }>;
+}
+
+export class FsYamlKnowledgeRepo {
+  private basePath: string;
+  private _all: KnowledgeEntry[] | null = null;
+  private _dimensions: string[] | null = null;
+  private _analysisModels: AnalysisModel[] | null = null;
+  private _scenarioPacks: ScenarioPack[] | null = null;
+  private _personas: Persona[] | null = null;
+
+  constructor(basePath?: string) {
+    this.basePath = basePath ?? defaultBasePath();
+  }
+
+  /** Load the dimensions registry from _registry/dimensions.yaml */
+  private loadDimensions(): string[] {
+    if (this._dimensions) return this._dimensions;
+    const path = join(this.basePath, "_registry", "dimensions.yaml");
+    if (!existsSync(path)) {
+      throw new Error(`维度注册表不存在: ${path}`);
+    }
+    const raw = yaml.load(readFileSync(path, "utf-8")) as DimensionRegistry;
+    if (!raw || !Array.isArray(raw.dimensions)) {
+      throw new Error(`维度注册表格式错误: ${path}`);
+    }
+    const dims = raw.dimensions.map((d) => d.id);
+    this._dimensions = dims;
+    return dims;
+  }
+
+  /** Collect all .yaml file paths under basePath, excluding _schema/, _registry/ and tests/ */
+  private collectYamlFiles(dir: string, root: string): string[] {
+    const files: string[] = [];
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      const fullPath = join(dir, entry.name);
+      if (entry.isDirectory()) {
+        // Skip non-content directories.
+        // analysis-models/ 与 scenario-packs/ 是 COACH-MOD 新增内容类型，
+        // 用独立 schema（非 knowledgeEntrySchema），不能被 loadAll 当处方条目校验，
+        // 否则 validate 报错 / T13 迁移等价性断言崩。它们由 loadAnalysisModels
+        // / loadScenarioPacks 单独加载。
+        if (
+          entry.name === "_schema" ||
+          entry.name === "_registry" ||
+          entry.name === "tests" ||
+          entry.name === "analysis-models" ||
+          entry.name === "scenario-packs"
+        )
+          continue;
+        files.push(...this.collectYamlFiles(fullPath, root));
+      } else if (entry.isFile() && entry.name.endsWith(".yaml")) {
+        files.push(fullPath);
+      }
+    }
+    return files;
+  }
+
+  async loadAll(): Promise<KnowledgeEntry[]> {
+    if (this._all) return this._all;
+
+    // Load registry first
+    const validDimensions = this.loadDimensions();
+
+    const yamlFiles = this.collectYamlFiles(this.basePath, this.basePath);
+    const entries: KnowledgeEntry[] = [];
+    const seenIds = new Set<string>();
+
+    for (const filePath of yamlFiles) {
+      const raw = yaml.load(readFileSync(filePath, "utf-8"));
+      const entry = validateEntry(raw);
+
+      // Check dimension is registered
+      if (!validDimensions.includes(entry.dimension)) {
+        throw new Error(
+          `维度 "${entry.dimension}" 未在 _registry/dimensions.yaml 中登记 ` +
+            `(文件: ${filePath})`
+        );
+      }
+
+      // Check duplicate ID
+      if (seenIds.has(entry.id)) {
+        throw new Error(`重复 ID: "${entry.id}" (文件: ${filePath})`);
+      }
+      seenIds.add(entry.id);
+
+      entries.push(entry);
+    }
+
+    this._all = entries;
+    return entries;
+  }
+
+  async getById(id: string): Promise<KnowledgeEntry | null> {
+    const entries = await this.loadAll();
+    return entries.find((e) => e.id === id) ?? null;
+  }
+
+  async byDimension(dimension: string): Promise<KnowledgeEntry[]> {
+    const entries = await this.loadAll();
+    return entries.filter((e) => e.dimension === dimension);
+  }
+
+  async matchBySignal(signal: TriggerSignal): Promise<KnowledgeEntry[]> {
+    const entries = await this.loadAll();
+    return entries.filter((e) => {
+      const signals = e.triggers.signals ?? [];
+      return signals.some((s) => {
+        // Quadrant match: exact
+        if (signal.quadrant && s.quadrant) {
+          if (s.quadrant !== signal.quadrant) return false;
+        } else if (signal.quadrant && !s.quadrant) {
+          return false;
+        }
+
+        // Daily total minutes: parse threshold
+        if (signal.daily_total_minutes && s.daily_total_minutes) {
+          const sv = parseThreshold(s.daily_total_minutes);
+          const qv = parseThreshold(signal.daily_total_minutes);
+          if (sv === null || qv === null) {
+            // If we can't parse, fall back to string equality
+            if (s.daily_total_minutes !== signal.daily_total_minutes) return false;
+          } else if (!matchesThreshold(s.daily_total_minutes, signal.daily_total_minutes)) {
+            return false;
+          }
+        } else if (signal.daily_total_minutes && !s.daily_total_minutes) {
+          return false;
+        }
+
+        // If neither signal field is being queried, no match
+        if (!signal.quadrant && !signal.daily_total_minutes) return false;
+
+        return true;
+      });
+    });
+  }
+
+  async matchBySymptom(symptom: string): Promise<KnowledgeEntry[]> {
+    const entries = await this.loadAll();
+    const lowerSymptom = symptom.toLowerCase();
+    return entries.filter((e) => {
+      const symptoms = e.triggers.symptoms ?? [];
+      return symptoms.some((s) => s.toLowerCase().includes(lowerSymptom));
+    });
+  }
+
+  /** Collect .yaml files directly under one content subdir (non-recursive). */
+  private collectDirYamlFiles(subdir: string): string[] {
+    const dir = join(this.basePath, subdir);
+    if (!existsSync(dir)) return [];
+    return readdirSync(dir, { withFileTypes: true })
+      .filter((e) => e.isFile() && e.name.endsWith(".yaml"))
+      .map((e) => join(dir, e.name));
+  }
+
+  /** COACH-MOD: load all analysis models from analysis-models/. */
+  async loadAnalysisModels(): Promise<AnalysisModel[]> {
+    if (this._analysisModels) return this._analysisModels;
+    const files = this.collectDirYamlFiles("analysis-models");
+    const models: AnalysisModel[] = [];
+    const seenIds = new Set<string>();
+    for (const filePath of files) {
+      const raw = yaml.load(readFileSync(filePath, "utf-8"));
+      const model = validateAnalysisModel(raw);
+      if (seenIds.has(model.id)) {
+        throw new Error(`重复分析模型 ID: "${model.id}" (文件: ${filePath})`);
+      }
+      seenIds.add(model.id);
+      models.push(model);
+    }
+    this._analysisModels = models;
+    return models;
+  }
+
+  /** COACH-MOD: load all scenario packs from scenario-packs/. */
+  async loadScenarioPacks(): Promise<ScenarioPack[]> {
+    if (this._scenarioPacks) return this._scenarioPacks;
+    const files = this.collectDirYamlFiles("scenario-packs");
+    const packs: ScenarioPack[] = [];
+    const seenIds = new Set<string>();
+    for (const filePath of files) {
+      const raw = yaml.load(readFileSync(filePath, "utf-8"));
+      const pack = validateScenarioPack(raw);
+      if (seenIds.has(pack.id)) {
+        throw new Error(`重复场景包 ID: "${pack.id}" (文件: ${filePath})`);
+      }
+      seenIds.add(pack.id);
+      packs.push(pack);
+    }
+    this._scenarioPacks = packs;
+    return packs;
+  }
+
+  /** COACH-MOD: load personas from _registry/personas.yaml. */
+  async loadPersonas(): Promise<Persona[]> {
+    if (this._personas) return this._personas;
+    const path = join(this.basePath, "_registry", "personas.yaml");
+    if (!existsSync(path)) {
+      this._personas = [];
+      return [];
+    }
+    const raw = yaml.load(readFileSync(path, "utf-8"));
+    const { personas } = validatePersonaRegistry(raw ?? {});
+    const seenIds = new Set<string>();
+    for (const p of personas) {
+      if (seenIds.has(p.id)) {
+        throw new Error(`重复画像 ID: "${p.id}" (文件: ${path})`);
+      }
+      seenIds.add(p.id);
+    }
+    this._personas = personas;
+    return personas;
+  }
+
+  /**
+   * COACH-MOD: return the single default analysis model (is_default: true).
+   * §4.5 显式声明：0 个或 >1 个默认都抛错（不静默返回 undefined / 第一个），
+   * 因为"复盘默认装一个基线"是硬约束（spec §2 ①原则·基线）。
+   */
+  async getDefaultAnalysisModel(): Promise<AnalysisModel> {
+    const models = await this.loadAnalysisModels();
+    const defaults = models.filter((m) => m.is_default);
+    if (defaults.length === 0) {
+      throw new Error("没有默认分析模型（需要恰好一个 is_default: true）");
+    }
+    if (defaults.length > 1) {
+      throw new Error(
+        `默认分析模型不唯一：${defaults.map((m) => m.id).join(", ")}（需要恰好一个 is_default: true）`,
+      );
+    }
+    return defaults[0]!;
+  }
+}
+
+/** Parse a threshold string like ">600" into { op: ">", value: 600 } */
+function parseThreshold(s: string): { op: string; value: number } | null {
+  const match = s.match(/^([><=]?)\s*(\d+)$/);
+  if (!match) return null;
+  return { op: match[1] || ">=", value: parseInt(match[2], 10) };
+}
+
+/** Check if the entry's daily_total_minutes matches the query threshold */
+function matchesThreshold(entryValue: string, queryValue: string): boolean {
+  const pv = parseThreshold(queryValue);
+  if (!pv) return entryValue === queryValue;
+
+  // For entry values that are plain numbers or threshold expressions
+  const entryMatch = entryValue.match(/^(\d+)$/);
+  if (entryMatch) {
+    const num = parseInt(entryMatch[1], 10);
+    switch (pv.op) {
+      case ">": return num > pv.value;
+      case "<": return num < pv.value;
+      case "=": return num === pv.value;
+      default: return num >= pv.value;
+    }
+  }
+
+  return entryValue === queryValue;
+}

package/knowledge/src/repo/types.ts

@@ -0,0 +1,24 @@
+import type { KnowledgeEntry } from "../../_schema/entry.schema.js";
+import type { AnalysisModel } from "../../_schema/analysis-model.schema.js";
+import type { ScenarioPack } from "../../_schema/scenario-pack.schema.js";
+import type { Persona } from "../../_schema/persona.schema.js";
+
+export type { KnowledgeEntry, AnalysisModel, ScenarioPack, Persona };
+
+export interface TriggerSignal {
+  quadrant?: "能耗黑洞" | "可放弃" | "保持区" | "亮点区";
+  daily_total_minutes?: string; // ">600" style
+}
+
+export interface KnowledgeRepo {
+  loadAll(): Promise<KnowledgeEntry[]>;
+  getById(id: string): Promise<KnowledgeEntry | null>;
+  byDimension(dimension: string): Promise<KnowledgeEntry[]>;
+  matchBySignal(signal: TriggerSignal): Promise<KnowledgeEntry[]>;
+  matchBySymptom(symptom: string): Promise<KnowledgeEntry[]>;
+  // COACH-MOD §3 复盘模块知识层
+  loadAnalysisModels(): Promise<AnalysisModel[]>;
+  loadScenarioPacks(): Promise<ScenarioPack[]>;
+  loadPersonas(): Promise<Persona[]>;
+  getDefaultAnalysisModel(): Promise<AnalysisModel>;
+}

package/knowledge/tests/fixtures/base/_registry/dimensions.yaml

@@ -0,0 +1,4 @@
+dimensions:
+  - id: time
+    label: 时间·做减法
+    proposition: 问题不是时间不够，而是塞得太满

package/knowledge/tests/fixtures/base/time/valid-entry.yaml

@@ -0,0 +1,24 @@
+id: test-valid-entry
+kind: prescription
+dimension: time
+title: 测试有效条目
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 拖延
+    - 承诺过多
+prescription:
+  one_liner: 这是一个测试处方
+  steps:
+    - 步骤一
+  micro_experiment: 测试微实验
+  verify: 验证方法
+source:
+  ref: 测试来源
+evidence_level: book
+applicability:
+  personas_fit: []
+  personas_avoid: []
+  boundaries: []
+tags: [测试]

package/knowledge/tests/fixtures/dup/_registry/dimensions.yaml

@@ -0,0 +1,4 @@
+dimensions:
+  - id: time
+    label: 时间·做减法
+    proposition: 问题不是时间不够，而是塞得太满

package/knowledge/tests/fixtures/dup/time/entry-a.yaml

@@ -0,0 +1,13 @@
+id: dup-entry
+kind: prescription
+dimension: time
+title: 重复条目 A
+triggers:
+  symptoms:
+    - 测试
+prescription:
+  one_liner: 测试
+  micro_experiment: 测试
+source:
+  ref: 测试
+evidence_level: book

package/knowledge/tests/fixtures/dup/time/entry-b.yaml

@@ -0,0 +1,13 @@
+id: dup-entry
+kind: prescription
+dimension: time
+title: 重复条目 B
+triggers:
+  symptoms:
+    - 测试
+prescription:
+  one_liner: 测试
+  micro_experiment: 测试
+source:
+  ref: 测试
+evidence_level: book

package/knowledge/tests/fixtures/unregistered/_registry/dimensions.yaml

@@ -0,0 +1,7 @@
+dimensions:
+  - id: time
+    label: 时间·做减法
+    proposition: 问题不是时间不够，而是塞得太满
+  - id: energy
+    label: 精力·做循环
+    proposition: 表现 = 刺激 + 恢复

package/knowledge/tests/fixtures/unregistered/time/anxiety-entry.yaml

@@ -0,0 +1,13 @@
+id: anxiety-test
+kind: prescription
+dimension: anxiety
+title: 未注册维度测试
+triggers:
+  symptoms:
+    - 测试
+prescription:
+  one_liner: 测试
+  micro_experiment: 测试
+source:
+  ref: 测试
+evidence_level: book