libero3 0.3.0

package/COLD_START.md

@@ -0,0 +1,31 @@
+# libero 冷启动（host agent 专用，不是用户手册）
+
+> **禁止**把本文当成用户步骤（「请你让 agent 读这个文件」= 产品失败）。  
+> 用户只说「帮我装 libero」或跑 `npm i -g libero-mcp@latest`。欢迎必须由 host **自动**发出。
+
+## Host 在装机时自动做
+
+1. 跑 `npm i -g libero-mcp@latest`（postinstall 会在 stderr 打印 `LIBERO_HOST_ACTION` + 欢迎原文）
+2. **立刻**把欢迎原文作为下一条对用户的回复发出（不要列工具、不要问 user_id）
+3. 再写 `mcp_servers.libero.command: libero-mcp`（如需）并 `/reload-mcp`
+
+## 欢迎原文
+
+```
+你好，我是 libero，帮你管时间和精力。
+
+常用这几件事，直接说就行：
+• 计时：「开始计时写代码」/「开个 25 分钟番茄钟」
+• 日程：「明天 9 点到 11 点写报告」
+• 拆任务：「这个太大了，帮我拆一下」
+• 看数据：「这周时间都花哪儿了」
+• 复盘：「帮我复盘一下这周」
+
+想先试哪一句？
+```
+
+## 硬规矩
+
+- **禁止问 user_id**（从会话上下文静默取；取不到用 `local:default`）
+- 不要提 MCP / 工具表 / DB / YAML
+- 用户选了例句 → 直接执行，不要重复整段介绍

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 amosyuan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# libero
+
+AI 辅助的精力管理教练：观察实绩 → 发现问题 → 对齐方案 → AI 辅助达成。
+
+> 2.0 = 一组 Skills（脑）+ 一层 MCP 工具（手）+ 一个数据后端（记忆），骑 Hermes / OpenClaw，本地优先。
+
+## 快速开始
+
+```bash
+npm i -g libero-mcp@latest
+```
+
+或对你的 agent 说一句：**帮我装 libero**。
+
+装完后你会直接看到欢迎与试用例句（计时 / 日程 / 拆任务 / 看数据 / 复盘）。  
+不需要再配置、不需要起 user_id、不需要提醒 agent「去读某个文件」。
+
+试试说：
+
+> 开始计时写代码
+
+## 能说什么
+
+| 想做的事 | 这样说 |
+|---|---|
+| 开始一段专注 | "开始计时写代码" / "开个 25 分钟番茄钟读书" |
+| 停下来 | "停一下" / "看看今天计了多久" |
+| 安排日程 | "明天 9 点到 11 点写报告" |
+| 看时间分布 | "这周时间都花哪儿了" |
+| 复盘 | "复盘一下这周" |
+| 拆任务 | "这个任务太大，帮我拆一下" |
+
+## 升级
+
+```bash
+npm update -g libero-mcp
+```
+
+## 给开发者 / host 实现者
+
+- Host 装机自动行为见 [COLD_START.md](COLD_START.md)（**不是**用户步骤）
+- 协作宪法：[AGENTS.md](AGENTS.md)
+- 排查：[docs/operations/deploy-to-hermes.md](docs/operations/deploy-to-hermes.md)

package/data/migrations/001_initial_schema.sql

@@ -0,0 +1,43 @@
+-- 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,
+  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,
+  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'))
+);

package/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/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/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/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/data/migrations/006_add_timeblock_status.sql

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

package/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/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/data/db.js

@@ -0,0 +1,83 @@
+import Database from "better-sqlite3";
+import { mkdirSync, readFileSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+let instance = null;
+function runMigrations(db) {
+    db.exec(`
+    CREATE TABLE IF NOT EXISTS _migrations (
+      version INTEGER PRIMARY KEY,
+      name TEXT NOT NULL,
+      applied_at TEXT NOT NULL DEFAULT (datetime('now'))
+    );
+  `);
+    const migrationsDir = join(import.meta.dirname, "migrations");
+    const files = readdirSync(migrationsDir)
+        .filter((f) => f.endsWith(".sql"))
+        .sort();
+    const applied = new Set(db.prepare("SELECT version FROM _migrations").all().map((r) => r.version));
+    for (const file of files) {
+        const match = file.match(/^(\d+)_/);
+        if (!match)
+            continue;
+        const version = parseInt(match[1], 10);
+        if (applied.has(version))
+            continue;
+        const sql = readFileSync(join(migrationsDir, file), "utf-8");
+        try {
+            db.exec(sql);
+        }
+        catch (e) {
+            // §4.5 显式折叠声明：手动改过生产 DB（如 ALTER TABLE 加字段）但忘了在
+            // _migrations 补记，下次启动 runMigrations 重跑会撞"已存在"错误。
+            // 这类错误 = 字段/表/索引已在那，migration 的目标其实达成了 → 容错记为已应用，
+            // 不让 gateway 启动卡死。其他错误（语法错、真缺字段）仍真抛。
+            //
+            // 2026-08-11 S48 教训：手动 ALTER TABLE time_blocks ADD asked_at 后没补 _migrations，
+            // gateway 重启跑 015 撞 duplicate column → MCP 崩 → hermes parking。
+            const msg = e.message ?? "";
+            const isAlreadyExists = msg.includes("duplicate column name") ||
+                msg.includes("already exists") ||
+                msg.includes("duplicate object");
+            if (!isAlreadyExists)
+                throw e;
+        }
+        db.prepare("INSERT INTO _migrations (version, name) VALUES (?, ?)").run(version, file);
+    }
+}
+export function initDb(dbPath) {
+    if (instance) {
+        instance.close();
+        instance = null;
+    }
+    // 父目录不存在时自动创建（recursive），避免 SQLITE_CANTOPEN
+    // 2026-07-17：hermes 装机后默认 cwd 无 ./data/ → 用户看到"缺少数据库目录"
+    mkdirSync(dirname(dbPath), { recursive: true });
+    const db = new Database(dbPath);
+    db.pragma("journal_mode = WAL");
+    db.pragma("foreign_keys = ON");
+    runMigrations(db);
+    instance = db;
+    return db;
+}
+export function getDb() {
+    if (!instance) {
+        throw new Error("Database not initialized. Call initDb() first.");
+    }
+    return instance;
+}
+export function closeDb() {
+    if (instance) {
+        instance.close();
+        instance = null;
+    }
+}
+const entry = process.argv[1];
+if (entry && fileURLToPath(import.meta.url) === entry) {
+    // CLI 模式：默认 ~/.libero/libero.db（与 server.ts 保持一致）
+    const dbPath = process.env.DB_PATH ?? join(homedir(), ".libero", "libero.db");
+    initDb(dbPath);
+    console.log(`DB initialized at ${dbPath}`);
+    closeDb();
+}

package/dist/data/migrations/001_initial_schema.sql

@@ -0,0 +1,43 @@
+-- 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,
+  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,
+  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'))
+);