libero3 0.3.0

package/dist/data/migrations/002_seed_categories.sql

@@ -0,0 +1,18 @@
+-- 002_seed_categories: libero 2.0 默认 15 分类
+
+INSERT INTO categories (id, name, emoji, color) VALUES
+  ('cat-work',     '工作', '💼', '#4A90D9'),
+  ('cat-study',    '学习', '📚', '#7B68EE'),
+  ('cat-create',   '创作', '✍️', '#E67E22'),
+  ('cat-sleep',    '睡眠', '😴', '#34495E'),
+  ('cat-eat',      '餐饮', '🍽️', '#E74C3C'),
+  ('cat-chore',    '内务', '🏠', '#95A5A6'),
+  ('cat-commute',  '通勤', '🚗', '#1ABC9C'),
+  ('cat-exercise', '运动', '🏃', '#2ECC71'),
+  ('cat-meditate', '冥想', '🧘', '#9B59B6'),
+  ('cat-medical',  '医疗', '🏥', '#E91E63'),
+  ('cat-social',   '社交', '👥', '#FF6F00'),
+  ('cat-family',   '陪伴', '👨‍👩‍👧', '#00BCD4'),
+  ('cat-play',     '娱乐', '🎮', '#F39C12'),
+  ('cat-idle',     '闲散', '☕', '#BDC3C7'),
+  ('cat-other',    '其他', '❓', '#7F8C8D');

package/dist/data/migrations/003_add_rating.sql

@@ -0,0 +1,4 @@
+-- 003_add_rating: time_blocks 增加评分字段
+
+ALTER TABLE time_blocks ADD COLUMN rating INTEGER;
+ALTER TABLE time_blocks ADD COLUMN rating_reason TEXT;

package/dist/data/migrations/004_timer_sessions.sql

@@ -0,0 +1,21 @@
+-- 004_timer_sessions: multi-user persistent timer state
+-- Eliminates module-level global `let state` (architecture pitfall A2).
+-- Stores started_at + accumulated_ms invariants; elapsed is always recomputed.
+
+CREATE TABLE IF NOT EXISTS timer_sessions (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  event TEXT NOT NULL,
+  category_id TEXT,
+  status TEXT NOT NULL DEFAULT 'running',
+  started_at TEXT NOT NULL,
+  accumulated_ms INTEGER NOT NULL DEFAULT 0,
+  ended_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  FOREIGN KEY (user_id) REFERENCES user_profile(id)
+);
+
+-- Speed up "find active session for user" (at most one running/paused per user)
+CREATE INDEX IF NOT EXISTS idx_timer_active
+  ON timer_sessions (user_id, status);

package/dist/data/migrations/005_profile_settings.sql

@@ -0,0 +1,5 @@
+-- 005_profile_settings: 结构化约定存为 JSON 列 (Q-14 决策)
+-- 为 onboarding 和 coach 提供结构化约定的存储字段
+ALTER TABLE user_profile ADD COLUMN settings TEXT;
+-- settings 存 JSON 字符串，形如：
+-- {"focus_areas":["工作","学习"],"goals":"每天专注 4h","rhythm":"番茄钟","review_time":"每周日 20:00"}

package/dist/data/migrations/006_add_timeblock_status.sql

@@ -0,0 +1 @@
+ALTER TABLE time_blocks ADD COLUMN status TEXT NOT NULL DEFAULT 'completed';

package/dist/data/migrations/007_reminders.sql

@@ -0,0 +1,17 @@
+CREATE TABLE IF NOT EXISTS reminders (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  timeblock_id TEXT,
+  content TEXT NOT NULL,
+  remind_at TEXT NOT NULL,
+  channel TEXT NOT NULL DEFAULT 'session',
+  status TEXT NOT NULL DEFAULT 'pending',
+  attempts INTEGER NOT NULL DEFAULT 0,
+  sent_at TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  deleted_at TEXT,
+  FOREIGN KEY (user_id) REFERENCES user_profile(id)
+);
+CREATE INDEX IF NOT EXISTS idx_reminders_due
+  ON reminders (status, remind_at) WHERE deleted_at IS NULL;

package/dist/data/migrations/008_timer_target_ms.sql

@@ -0,0 +1,5 @@
+-- 008_timer_target_ms: add focus target duration to timer_sessions
+-- S26: pomodoro v1 — target_ms tracks the goal duration (e.g. 25min = 1500000ms)
+-- NULL = normal timer (backward compatible)
+
+ALTER TABLE timer_sessions ADD COLUMN target_ms INTEGER;

package/dist/data/migrations/009_tasks.sql

@@ -0,0 +1,22 @@
+-- 009_tasks: 任务拆解（P2-3, S29 §3.1）
+-- coaching 制品：低摩擦冷启动 + ≤25min 子任务方案
+
+CREATE TABLE IF NOT EXISTS tasks (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  parent_id TEXT,                       -- NULL=根任务, 否则子任务(自引用)
+  title TEXT NOT NULL,
+  status TEXT NOT NULL DEFAULT 'draft', -- draft/aligned/executing/done/abandoned
+  est_minutes INTEGER,                  -- 预估(冷启动不限, 其余≤25min)
+  category_id TEXT,
+  linked_timeblock_id TEXT,             -- 排/执行时关联 time_block
+  order_index INTEGER DEFAULT 0,        -- 同级顺序
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  deleted_at TEXT,
+  FOREIGN KEY (user_id) REFERENCES user_profile(id),
+  FOREIGN KEY (parent_id) REFERENCES tasks(id),
+  FOREIGN KEY (category_id) REFERENCES categories(id),
+  FOREIGN KEY (linked_timeblock_id) REFERENCES time_blocks(id)
+);
+CREATE INDEX IF NOT EXISTS idx_tasks_user_parent ON tasks (user_id, parent_id);

package/dist/data/migrations/010_timer_task_id.sql

@@ -0,0 +1,4 @@
+-- 010_timer_task_id: timer_sessions 加 task_id（S29 §3.2）
+-- 子任务开工走计时器时关联 task_id；计时结束 → 凭 task_id 触发闭环反馈
+
+ALTER TABLE timer_sessions ADD COLUMN task_id TEXT REFERENCES tasks(id);

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/migrations/012_identity_tables.sql

@@ -0,0 +1,68 @@
+-- 012_identity_tables: S40 跨平台身份层
+-- 新建 user_identity（1 真人 = 1 行）+ user_platform_alias（1 用户 ↔ N 平台 chat_id）表
+-- 为每个现存 user_profile.id（旧 chat_id）自动建对应 libero_user_id + alias 兜底行
+--
+-- §4.5 静默折叠声明：
+-- 1. 现有 user_profile.id 字段值不立刻改成 libero_user_id（保持 chat_id 不动）
+--    折叠意图：靠 mcp/src/identity/resolve.ts 的 resolveUserId 在运行时透明解析
+--    副作用：业务表（timeblock/timer/scheduler/reminder）的 user_id 字段也仍是 chat_id
+--    slice 2 才全量 update 这些字段到 libero_user_id
+-- 2. 现有用户的 alias.platform 默认 'unknown'（migration 不猜平台）
+--    折叠意图：避免猜测出错（wecom chat_id vs feishu open_id 长得像）
+--    副作用：listMyChannels 第一次会看到 platform=unknown，主会话首次接触时问用户确认后调 bindAlias 修正
+
+CREATE TABLE IF NOT EXISTS user_identity (
+  libero_user_id TEXT PRIMARY KEY,        -- 'u_libero_xxxxxxxx' (UUID v4 截断)
+  display_name TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS user_platform_alias (
+  libero_user_id TEXT NOT NULL,
+  platform TEXT NOT NULL,                  -- 'wecom' / 'feishu' / 'telegram' / 'unknown'
+  platform_user_id TEXT NOT NULL,          -- 平台的 user/open id
+  chat_id TEXT,                            -- 投递用 chat_id（可等于 platform_user_id）
+  bound_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (platform, platform_user_id),
+  FOREIGN KEY (libero_user_id) REFERENCES user_identity(libero_user_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_alias_libero ON user_platform_alias(libero_user_id);
+
+-- 为现有每个 user_profile 行建对应 libero_user_id + alias 兜底行
+-- 用 substr(hex(randomblob(...))) 生成稳定长度的伪 UUID（避免依赖外部 UUID 函数）
+INSERT OR IGNORE INTO user_identity (libero_user_id, display_name, created_at, updated_at)
+SELECT
+  'u_libero_' || substr(hex(randomblob(8)), 1, 16),
+  CASE
+    WHEN LENGTH(id) <= 16 THEN id
+    ELSE SUBSTR(id, 1, 16)
+  END,
+  COALESCE(created_at, datetime('now')),
+  COALESCE(updated_at, datetime('now'))
+FROM user_profile
+WHERE id NOT LIKE 'u_libero_%';
+
+-- 为上面建的 identity 加 alias 兜底（platform='unknown'，主会话首次接触时修正）
+-- 用 user_profile.id + created_at 双键匹配（display_name 可能撞）
+INSERT OR IGNORE INTO user_platform_alias (libero_user_id, platform, platform_user_id, chat_id, bound_at)
+SELECT
+  (
+    SELECT ui.libero_user_id FROM user_identity ui
+    WHERE ui.display_name = CASE
+      WHEN LENGTH(up.id) <= 16 THEN up.id
+      ELSE SUBSTR(up.id, 1, 16)
+    END
+    ORDER BY ui.created_at LIMIT 1
+  ),
+  'unknown',
+  up.id,
+  up.id,
+  COALESCE(up.updated_at, datetime('now'))
+FROM user_profile up
+WHERE up.id NOT LIKE 'u_libero_%'
+  AND NOT EXISTS (
+    SELECT 1 FROM user_platform_alias upa
+    WHERE upa.platform = 'unknown' AND upa.platform_user_id = up.id
+  );

package/dist/data/migrations/013_identity_managed_by.sql

@@ -0,0 +1,3 @@
+-- S44 (2026-08-07): managed_by field for代管 forwarding
+-- 代管人 libero_user_id（NULL = 自己接收追问；非 NULL = 追问发给代管人）
+ALTER TABLE user_identity ADD COLUMN managed_by TEXT;

package/dist/data/migrations/014_task_difficulty_priority.sql

@@ -0,0 +1,6 @@
+-- S46 (2026-08-07): task difficulty/priority 持久化
+-- 用于"快速启动 + 峰终"智能排程
+-- 难度（easy/medium/hard，默认 medium）
+ALTER TABLE tasks ADD COLUMN difficulty TEXT DEFAULT 'medium';
+-- 优先级（high/medium/low，默认 medium）
+ALTER TABLE tasks ADD COLUMN priority TEXT DEFAULT 'medium';

package/dist/data/migrations/015_timeblock_asked_at.sql

@@ -0,0 +1,5 @@
+-- S48 (2026-08-11): time_blocks 加 asked_at 字段
+-- 用于 libero-cron-scan 幂等：每条 unverified/planned 只被扫描追问一次
+-- 写入时机：sweepStale 把条目放进 to_ask 后，caller 调 markAsked 标记
+-- 复位规则：用户回报（completed / 软删）后这条不再被扫；asked_at 永久保留作审计
+ALTER TABLE time_blocks ADD COLUMN asked_at TEXT;

package/dist/data/migrations/016_intent_columns.sql

@@ -0,0 +1,8 @@
+-- MV-COACH-5 slice 1 (2026-08-12): reminders 表升格为意图队列
+-- 用于 3F 架构：脑说意图 → 手记意图 + 调 adapter → adapter 翻译成宿主机制
+-- 复用现有列：remind_at（时间）、content（action_prompt）、timeblock_id（schedule_id）、status
+ALTER TABLE reminders ADD COLUMN intent_type TEXT;       -- pre_start_reminder / missed_check / daily_review / one_off_reminder
+ALTER TABLE reminders ADD COLUMN trigger_kind TEXT;      -- relative / absolute / recurring
+ALTER TABLE reminders ADD COLUMN trigger_payload TEXT;   -- JSON: {offset:"-15m", relative_to:"schedule.start"} 等
+ALTER TABLE reminders ADD COLUMN host_job_id TEXT;       -- adapter 写回（hermes cron job id）
+ALTER TABLE reminders ADD COLUMN host_kind TEXT;         -- "hermes_cron" / "openclaw" / "cc_pending"

package/dist/data/migrations/017_ap_wallet.sql

@@ -0,0 +1,25 @@
+-- INT-AP-tools R2 (2026-08-14): AP 账真源在 libero.db
+-- 契约: libero-homm/docs/specs/INT-AP-tools.md §3
+CREATE TABLE IF NOT EXISTS ap_wallet (
+  user_id TEXT PRIMARY KEY,
+  balance INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL
+);
+
+CREATE TABLE IF NOT EXISTS ap_credit_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  source TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);
+
+-- spend 幂等同 credit：同 key 只扣一次（spec §2b）
+CREATE TABLE IF NOT EXISTS ap_spend_log (
+  user_id TEXT NOT NULL,
+  idempotency_key TEXT NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, idempotency_key)
+);

package/dist/data/migrations/018_ap_rewards.sql

@@ -0,0 +1,21 @@
+-- INT-ap-rewards (2026-08-19): AP 换算引擎计数与事件幂等
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §4
+CREATE TABLE IF NOT EXISTS ap_reward_log (
+  user_id TEXT NOT NULL,
+  event_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  nth INTEGER NOT NULL,
+  amount INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, event_id)
+);
+
+CREATE TABLE IF NOT EXISTS ap_reward_counter (
+  user_id TEXT NOT NULL,
+  action_type TEXT NOT NULL,
+  period_key TEXT NOT NULL,
+  count INTEGER NOT NULL DEFAULT 0,
+  updated_at TEXT NOT NULL,
+  PRIMARY KEY (user_id, action_type, period_key)
+);

package/dist/data/migrations/019_ap_bounty.sql

@@ -0,0 +1,10 @@
+-- INT-ap-rewards 悬赏（方案 A，2026-08-19）：每日任务完成奖金，一日一任务只发一次
+-- 契约: libero-homm/docs/specs/INT-ap-rewards.md §悬赏
+CREATE TABLE IF NOT EXISTS ap_bounty_log (
+  user_id TEXT NOT NULL,
+  date_key TEXT NOT NULL,
+  quest_id TEXT NOT NULL,
+  bonus INTEGER NOT NULL,
+  created_at TEXT NOT NULL,
+  UNIQUE(user_id, date_key, quest_id)
+);

package/dist/data/migrations/020_chat_turns.sql

@@ -0,0 +1,10 @@
+-- 微信/REST chat 多轮上下文（2026-08-19）
+-- 只存 user/assistant 正文；tool 轮次不落盘
+CREATE TABLE IF NOT EXISTS chat_turns (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  conversation_key TEXT NOT NULL,
+  role TEXT NOT NULL,
+  content TEXT NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_chat_turns_key_id ON chat_turns (conversation_key, id);

package/dist/data/migrations/021_portrait.sql

@@ -0,0 +1,4 @@
+-- 账户画像：习惯与个人设置（非近期动作）。200 字硬顶，脏标记 + 刷新时间。
+ALTER TABLE user_profile ADD COLUMN portrait TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_refreshed_at TEXT;
+ALTER TABLE user_profile ADD COLUMN portrait_dirty INTEGER NOT NULL DEFAULT 0;

package/dist/data/migrations/022_family_emoji_single.sql

@@ -0,0 +1,3 @@
+-- 2026-09-02: 陪伴分类 👨‍👩‍👧（ZWJ 三人组）在 emoji 矩阵里占 3 格宽导致错位，
+-- 统一为单字素 👶（用户拍板：照顾孩子类用单一 emoji）。
+UPDATE categories SET emoji = '👶' WHERE id = 'cat-family';

package/dist/data/migrations/023_ap_balance_view_log.sql

@@ -0,0 +1,9 @@
+-- S3：看余额埋点（INT-mvp-100 游戏拉动信号）。只追加，不幂等去重——每次查询都是一次「看」。
+CREATE TABLE IF NOT EXISTS ap_balance_view_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  user_id TEXT NOT NULL,
+  balance INTEGER NOT NULL,
+  created_at TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_ap_balance_view_user_created
+  ON ap_balance_view_log (user_id, created_at);

package/dist/data/schema.sql

@@ -0,0 +1,75 @@
+-- 001_initial_schema: libero 2.0 核心表
+-- K1 合规：所有业务表带 UUID PK + created_at + updated_at + deleted_at（软删除）
+
+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
+);
+
+CREATE TABLE IF NOT EXISTS time_blocks (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  title TEXT NOT NULL,
+  category_id TEXT,
+  start_time TEXT NOT NULL,
+  end_time TEXT NOT NULL,
+  duration_minutes INTEGER,
+  notes TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  deleted_at TEXT,
+  -- status/rating/rating_reason 由后续 migration 加；此处不显式列（IF NOT EXISTS 不重建表）
+  -- asked_at（migration 015，S48）：扫描追问幂等标记，每条只主动问一次
+  FOREIGN KEY (user_id) REFERENCES user_profile(id)
+);
+
+CREATE TABLE IF NOT EXISTS categories (
+  id TEXT PRIMARY KEY,
+  name TEXT NOT NULL,
+  emoji TEXT DEFAULT '',
+  color TEXT DEFAULT '',
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+  deleted_at TEXT,
+  UNIQUE(name)
+);
+
+CREATE TABLE IF NOT EXISTS _migrations (
+  version INTEGER PRIMARY KEY,
+  name TEXT NOT NULL,
+  applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+-- 012_identity_tables: S40 跨平台身份层
+-- 1 真人 = 1 user_identity 行；N 平台 chat_id = N user_platform_alias 行
+CREATE TABLE IF NOT EXISTS user_identity (
+  libero_user_id TEXT PRIMARY KEY,
+  display_name TEXT,
+  created_at TEXT NOT NULL DEFAULT (datetime('now')),
+  updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+);
+
+CREATE TABLE IF NOT EXISTS user_platform_alias (
+  libero_user_id TEXT NOT NULL,
+  platform TEXT NOT NULL,
+  platform_user_id TEXT NOT NULL,
+  chat_id TEXT,
+  bound_at TEXT NOT NULL DEFAULT (datetime('now')),
+  PRIMARY KEY (platform, platform_user_id),
+  FOREIGN KEY (libero_user_id) REFERENCES user_identity(libero_user_id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_alias_libero ON user_platform_alias(libero_user_id);
+
+-- reminders 表由 007 migration 建，此处不显式列（IF NOT EXISTS 不重建表）
+-- MV-COACH-5 slice 1（migration 016）：reminders 升格为意图队列，加 5 列：
+--   intent_type / trigger_kind / trigger_payload / host_job_id / host_kind
+-- 详见 data/migrations/016_intent_columns.sql

package/dist/knowledge/_registry/dimensions.yaml

@@ -0,0 +1,10 @@
+dimensions:
+  - id: time
+    label: 时间·做减法
+    proposition: 问题不是时间不够，而是塞得太满
+  - id: energy
+    label: 精力·做循环
+    proposition: 表现 = 刺激 + 恢复
+  - id: brain-science
+    label: 脑科学·做杠杆
+    proposition: 系统大于意志力

package/dist/knowledge/_registry/personas.yaml

@@ -0,0 +1,7 @@
+# 画像注册表 — P2-2 展开（COACH-MOD §3.4）
+personas:
+  - id: kid-primary-school
+    label: 小学生
+    traits: [注意力时段短, 需要玩学平衡, 自主性在养成中]
+    constraints: [不宜长时段深度工作, 依赖家长协作]
+    tone_adjust: 更具体、更鼓励、目标更小（呼应 S15 §6 语气自适应）

package/dist/knowledge/_schema/analysis-model.schema.js

@@ -0,0 +1,32 @@
+import { z } from "zod";
+/**
+ * COACH-MOD §3.2 — 复盘分析模型 schema。
+ * 与 entry.schema.ts 解耦：分析模型不属于 prescription/principle/research，
+ * 是复盘时脑装载的"分析框架/步骤"。全库唯一一个 is_default:true 作基线。
+ */
+export const analysisModelSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/),
+    kind: z.literal("analysis-model"),
+    title: z.string().min(1),
+    is_default: z.boolean().optional().default(false),
+    triggers: z
+        .object({
+        // 手层粗筛用的情境标签（coachmod.suggest 匹配）
+        context_tags: z.array(z.string()).optional().default([]),
+    })
+        .optional()
+        .default({ context_tags: [] }),
+    description: z.string().min(1),
+    // 分析框架/步骤（脑装载后据此复盘）
+    method: z.array(z.string()).min(1, { message: "method 至少一步" }),
+    output_shape: z.array(z.string()).optional().default([]),
+    source: z.object({
+        ref: z.string().min(1),
+        evidence_level: z
+            .enum(["research-rct", "research-observational", "book", "framework", "folk"])
+            .optional(),
+    }),
+});
+export function validateAnalysisModel(data) {
+    return analysisModelSchema.parse(data);
+}

package/dist/knowledge/_schema/entry.schema.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+const triggerSignalSchema = z.object({
+    quadrant: z.enum(["能耗黑洞", "可放弃", "保持区", "亮点区"]).optional(),
+    daily_total_minutes: z.string().optional(), // like ">600"
+});
+export const knowledgeEntrySchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/),
+    kind: z.enum(["prescription", "principle", "research"]),
+    dimension: z.string().min(1),
+    title: z.string().min(1),
+    triggers: z.object({
+        signals: z.array(triggerSignalSchema).optional().default([]),
+        symptoms: z.array(z.string()).optional().default([]),
+    }).refine(v => (v.signals?.length || 0) + (v.symptoms?.length || 0) > 0, {
+        message: "triggers: signals 与 symptoms 至少有一个非空（否则永远召不回）",
+    }),
+    prescription: z.object({
+        one_liner: z.string(),
+        steps: z.array(z.string()).optional(),
+        micro_experiment: z.string(),
+        verify: z.string().optional(),
+    }).optional(),
+    source: z.object({
+        ref: z.string().min(1),
+        cite_url: z.string().optional(),
+    }),
+    evidence_level: z.enum(["research-rct", "research-observational", "book", "framework", "folk"]),
+    evidence_note: z.string().optional(),
+    applicability: z.object({
+        personas_fit: z.array(z.string()).default([]),
+        personas_avoid: z.array(z.string()).default([]),
+        boundaries: z.array(z.string()).default([]),
+    }).optional().default({ personas_fit: [], personas_avoid: [], boundaries: [] }),
+    tags: z.array(z.string()).optional().default([]),
+}).refine(data => {
+    if (data.kind === "prescription") {
+        return data.prescription !== undefined
+            && data.prescription.one_liner.length > 0
+            && data.prescription.micro_experiment.length > 0;
+    }
+    return true;
+}, { message: "kind=prescription 时 prescription.one_liner 与 micro_experiment 必填" });
+export function validateEntry(data) {
+    return knowledgeEntrySchema.parse(data);
+}

package/dist/knowledge/_schema/persona.schema.js

@@ -0,0 +1,23 @@
+import { z } from "zod";
+/**
+ * COACH-MOD §3.4 — 画像 schema。
+ * 画像驱动语气/视角自适应（呼应 S15 §6）。存于 _registry/personas.yaml 的 personas 列表。
+ */
+export const personaSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/),
+    label: z.string().min(1),
+    traits: z.array(z.string()).optional().default([]),
+    constraints: z.array(z.string()).optional().default([]),
+    // 语气自适应说明（S15 §6）
+    tone_adjust: z.string().optional(),
+});
+/** _registry/personas.yaml 顶层结构：{ personas: [...] } */
+export const personaRegistrySchema = z.object({
+    personas: z.array(personaSchema).optional().default([]),
+});
+export function validatePersona(data) {
+    return personaSchema.parse(data);
+}
+export function validatePersonaRegistry(data) {
+    return personaRegistrySchema.parse(data);
+}

package/dist/knowledge/_schema/scenario-pack.schema.js

@@ -0,0 +1,29 @@
+import { z } from "zod";
+/**
+ * COACH-MOD §3.3 — 场景包 schema。
+ * 场景包 = 一个情境入口，内含推荐画像 + 推荐分析模型 + 场景专属提示。
+ * 装一个全来（recommends 展开），仍可单换（coachmod.load 单 id）。
+ */
+export const scenarioPackSchema = z.object({
+    id: z.string().regex(/^[a-z0-9-]+$/),
+    kind: z.literal("scenario-pack"),
+    title: z.string().min(1),
+    triggers: z.object({
+        // 手层粗筛用的情境标签（coachmod.suggest 匹配），至少一个否则永远召不回
+        context_tags: z
+            .array(z.string())
+            .min(1, { message: "triggers.context_tags 至少一个（否则永远召不回）" }),
+    }),
+    recommends: z.object({
+        persona_id: z.string().min(1),
+        analysis_model_ids: z
+            .array(z.string())
+            .min(1, { message: "recommends.analysis_model_ids 至少一个" }),
+        // 场景专属提示（脑装载后遵循）
+        subskill_prompt: z.string().min(1),
+    }),
+    description: z.string().min(1),
+});
+export function validateScenarioPack(data) {
+    return scenarioPackSchema.parse(data);
+}

package/dist/knowledge/analysis-models/review-default.yaml

@@ -0,0 +1,16 @@
+id: review-default
+kind: analysis-model
+title: 通用复盘基线模型
+is_default: true
+triggers:
+  context_tags: []
+description: 复盘默认基线——不假设特定人群/场景，只按"事实-感受-模式-下一步"四段温和过一遍
+method:
+  - 先摆事实：这段时间实际发生了什么（记录/数据说了什么，不加评判）
+  - 再看感受：哪些让你有能量、哪些消耗你（对齐评分/情绪）
+  - 找模式：反复出现的黑洞或亮点是什么（不是单次波动）
+  - 落一步：只挑一个最小可动的下一步，别一次改太多
+output_shape: [关键事实, 能量分布, 反复模式, 下一步微调]
+source:
+  ref: libero coach 通用复盘框架（内置基线）
+  evidence_level: framework

package/dist/knowledge/analysis-models/review-summer-plan.yaml

@@ -0,0 +1,15 @@
+id: review-summer-plan
+kind: analysis-model
+title: 暑期规划复盘模型
+is_default: false
+triggers:
+  context_tags: [暑假, 假期计划, 学生, 暑期]
+description: 面向假期长周期的"目标-节律-弹性"三段复盘
+method:
+  - 先看整段假期的目标锚点（学/玩/习惯各占多少，是否失衡）
+  - 再看每日节律是否可持续（是塞满还是留白，能不能天天照做）
+  - 留弹性缓冲，防计划一崩全崩（预设"崩了怎么接回"）
+output_shape: [目标达成度, 节律可持续性, 弹性评估, 下一步微调]
+source:
+  ref: libero coach 假期规划框架（目标-节律-弹性）
+  evidence_level: framework

package/dist/knowledge/brain-science/brain-deep-warmup.yaml

@@ -0,0 +1,22 @@
+id: brain-deep-warmup
+kind: prescription
+dimension: brain-science
+title: 深度预热仪式
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 任务启动困难
+    - 不知道从哪开始
+prescription:
+  one_liner: 固定开工动作：清理桌面 → 写 3 个子问题 → 关通知 → 全屏
+  steps:
+    - 清理桌面
+    - 写下 3 个子问题
+    - 关通知 + 全屏
+  micro_experiment: 明天开工前执行预热仪式（清理桌面+写3个子问题+关通知+全屏）
+  verify: 从坐下到进入状态的时长
+source:
+  ref: 《深度工作》(Deep Work, Cal Newport)
+evidence_level: book
+tags: [专注, 仪式]

package/dist/knowledge/brain-science/brain-emotion-granularity.yaml

@@ -0,0 +1,22 @@
+id: brain-emotion-granularity
+kind: prescription
+dimension: brain-science
+title: 提升情绪词汇颗粒度
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 情绪波动影响工作
+    - 说不清什么感觉
+prescription:
+  one_liner: 把"我很糟"细分为"焦虑 / 失望 / 疲惫"，然后先调身体（睡眠/进食/运动）
+  steps:
+    - 当感觉"很糟"时停下来
+    - 用更精确的词描述（焦虑/失望/疲惫/无聊）
+    - 先检查身体需求（睡眠/进食/运动）
+  micro_experiment: 下次感觉"很糟"时，用 3 个精确词描述，先喝杯水或走一走
+  verify: 情绪精确描述后是否更容易找到应对方法
+source:
+  ref: 《情绪的解析》(How Emotions Are Made, Lisa Feldman Barrett)
+evidence_level: book
+tags: [情绪, 自我觉察]

package/dist/knowledge/brain-science/brain-env-engineering.yaml

@@ -0,0 +1,22 @@
+id: brain-env-engineering
+kind: prescription
+dimension: brain-science
+title: 环境工程四法则
+triggers:
+  signals:
+    - quadrant: 能耗黑洞
+  symptoms:
+    - 分心频繁
+    - 环境干扰
+prescription:
+  one_liner: 让好习惯显而易见（如运动鞋放门口）+ 让坏习惯变难（App 移出主屏）
+  steps:
+    - 选一个好习惯，让它显而易见
+    - 选一个坏习惯，让它变困难
+    - 每天观察效果
+  micro_experiment: 运动鞋放门口 + 最分心的 App 移出主屏
+  verify: 好习惯被触发的次数、坏习惯被阻挡的次数
+source:
+  ref: 《掌控习惯》(Atomic Habits, James Clear)
+evidence_level: book
+tags: [环境, 习惯设计]