dsh-hams 0.1.3 → 0.1.4

package/src/store/schema/002_knowledge.sql

@@ -1,54 +0,0 @@
--- ⚠️ 自动生成，请勿手改。
--- 来源（权威）：docs/schema-2026-11-14.sql
--- 权威文件 sha256：91590bcaaeb9612f800a39297d4effe9ddcb419dbb822de1a3eb268be6969ec7
--- 生成命令：node scripts/split-schema.mjs
--- 内容：v2 知识 4 表 / 0 索引 / 0 触发器 / 0 种子语句
--- 分期依据：权威 DDL 里 [P2] 且表名属于知识子集的表；v1 已建的 41 张 P1 表不重复。
--- ───────────────────────── 2. 知识 ─────────────────────────
-CREATE TABLE kb_table (                  -- [P2]
-  id                TEXT PRIMARY KEY,
-  name              TEXT NOT NULL,
-  source_kind       TEXT NOT NULL CHECK (source_kind IN ('hive','lark_base','local','webhook')),
-  source_ref        TEXT,
-  schema_json       TEXT NOT NULL,
-  field_map_status  TEXT NOT NULL DEFAULT 'ok' CHECK (field_map_status IN ('ok','missing')),
-  updated_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_doc (                    -- [P2]
-  id                TEXT PRIMARY KEY,
-  title             TEXT NOT NULL,
-  body_ref          TEXT NOT NULL,                   -- 绝对路径或 URL；面板内撰写的落在 hams/knowledge/docs
-  revision          INTEGER NOT NULL DEFAULT 1,
-  owner_id          TEXT NOT NULL REFERENCES member(id),
-  source_kind       TEXT NOT NULL DEFAULT 'hams'
-                    CHECK (source_kind IN ('hams','file')),   -- hams=面板内撰写；file=导入的本地文件
-  content_hash      TEXT NOT NULL DEFAULT '',        -- sha256(原文)，用于判断磁盘上的文件是否被外部改动
-  bytes             INTEGER NOT NULL DEFAULT 0,
-  status            TEXT NOT NULL DEFAULT 'draft'
-                    CHECK (status IN ('draft','published','archived')),
-  updated_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_skill (                  -- [P2]
-  id                TEXT PRIMARY KEY,
-  name              TEXT NOT NULL UNIQUE,
-  domain            TEXT,
-  published_version_id TEXT REFERENCES kb_skill_version(id),  -- NULL = 尚无已发布版本
-  usage_count       INTEGER NOT NULL DEFAULT 0,
-  created_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_skill_version (          -- [P2] 发布走 approval(subject_kind='skill_publish')
-  id                TEXT PRIMARY KEY,
-  skill_id          TEXT NOT NULL REFERENCES kb_skill(id),
-  version           TEXT NOT NULL,
-  manifest_json     TEXT NOT NULL,
-  content_hash      TEXT NOT NULL,
-  status            TEXT NOT NULL DEFAULT 'draft'
-                    CHECK (status IN ('draft','in_review','published','retired')),
-  authored_by       TEXT NOT NULL REFERENCES member(id),
-  published_by      TEXT REFERENCES member(id),
-  published_at      INTEGER,
-  UNIQUE (skill_id, version)
-);

package/src/store/schema/002_knowledge.sql.ts

@@ -1,68 +0,0 @@
-// ⚠️ 自动生成，请勿手改。生成命令：node scripts/split-schema.mjs
-// 来源：docs/schema-2026-11-14.sql（sha256 91590bcaaeb9612f800a39297d4effe9ddcb419dbb822de1a3eb268be6969ec7）
-// v2 迁移：只含知识四张表；其余 P2/壳表仍按分期后置。
-
-export const KNOWLEDGE_SCHEMA_SQL = `-- ⚠️ 自动生成，请勿手改。
--- 来源（权威）：docs/schema-2026-11-14.sql
--- 权威文件 sha256：91590bcaaeb9612f800a39297d4effe9ddcb419dbb822de1a3eb268be6969ec7
--- 生成命令：node scripts/split-schema.mjs
--- 内容：v2 知识 4 表 / 0 索引 / 0 触发器 / 0 种子语句
--- 分期依据：权威 DDL 里 [P2] 且表名属于知识子集的表；v1 已建的 41 张 P1 表不重复。
--- ───────────────────────── 2. 知识 ─────────────────────────
-CREATE TABLE kb_table (                  -- [P2]
-  id                TEXT PRIMARY KEY,
-  name              TEXT NOT NULL,
-  source_kind       TEXT NOT NULL CHECK (source_kind IN ('hive','lark_base','local','webhook')),
-  source_ref        TEXT,
-  schema_json       TEXT NOT NULL,
-  field_map_status  TEXT NOT NULL DEFAULT 'ok' CHECK (field_map_status IN ('ok','missing')),
-  updated_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_doc (                    -- [P2]
-  id                TEXT PRIMARY KEY,
-  title             TEXT NOT NULL,
-  body_ref          TEXT NOT NULL,                   -- 绝对路径或 URL；面板内撰写的落在 hams/knowledge/docs
-  revision          INTEGER NOT NULL DEFAULT 1,
-  owner_id          TEXT NOT NULL REFERENCES member(id),
-  source_kind       TEXT NOT NULL DEFAULT 'hams'
-                    CHECK (source_kind IN ('hams','file')),   -- hams=面板内撰写；file=导入的本地文件
-  content_hash      TEXT NOT NULL DEFAULT '',        -- sha256(原文)，用于判断磁盘上的文件是否被外部改动
-  bytes             INTEGER NOT NULL DEFAULT 0,
-  status            TEXT NOT NULL DEFAULT 'draft'
-                    CHECK (status IN ('draft','published','archived')),
-  updated_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_skill (                  -- [P2]
-  id                TEXT PRIMARY KEY,
-  name              TEXT NOT NULL UNIQUE,
-  domain            TEXT,
-  published_version_id TEXT REFERENCES kb_skill_version(id),  -- NULL = 尚无已发布版本
-  usage_count       INTEGER NOT NULL DEFAULT 0,
-  created_at        INTEGER NOT NULL
-);
-
-CREATE TABLE kb_skill_version (          -- [P2] 发布走 approval(subject_kind='skill_publish')
-  id                TEXT PRIMARY KEY,
-  skill_id          TEXT NOT NULL REFERENCES kb_skill(id),
-  version           TEXT NOT NULL,
-  manifest_json     TEXT NOT NULL,
-  content_hash      TEXT NOT NULL,
-  status            TEXT NOT NULL DEFAULT 'draft'
-                    CHECK (status IN ('draft','in_review','published','retired')),
-  authored_by       TEXT NOT NULL REFERENCES member(id),
-  published_by      TEXT REFERENCES member(id),
-  published_at      INTEGER,
-  UNIQUE (skill_id, version)
-);
-`
-
-export const KNOWLEDGE_SCHEMA_META = {
-  authority: "docs/schema-2026-11-14.sql",
-  authoritySha256: "91590bcaaeb9612f800a39297d4effe9ddcb419dbb822de1a3eb268be6969ec7",
-  tables: 4,
-  tableNames: ["kb_table","kb_doc","kb_skill","kb_skill_version"] as const,
-} as const
-
-export type KnowledgeSchemaMeta = typeof KNOWLEDGE_SCHEMA_META

package/src/store/schema/003_projects.sql.ts

@@ -1,3 +0,0 @@
-// Generated by node src/store/schema/generate-projects.mjs; source docs/schema-2026-11-14.sql
-export const PROJECTS_SCHEMA_META = {"authority":"docs/schema-2026-11-14.sql","authoritySha256":"91590bcaaeb9612f800a39297d4effe9ddcb419dbb822de1a3eb268be6969ec7","tableNames":["project_phase","project_phase_target","project_phase_check","project_review","project_review_metric","activity_daily","member_version_skill"]} as const
-export const PROJECTS_SCHEMA_SQL = "CREATE TABLE member_version_skill (      -- [P2] 技能绑定在不可变的配置版本上\n  member_version_id TEXT NOT NULL REFERENCES member_version(id),\n  skill_id          TEXT NOT NULL REFERENCES kb_skill(id),\n  skill_version_id  TEXT NOT NULL REFERENCES kb_skill_version(id),\n  PRIMARY KEY (member_version_id, skill_id)\n);\n\nCREATE TABLE project_phase (             -- [P2]\n  id                TEXT PRIMARY KEY,\n  project_id        TEXT NOT NULL REFERENCES project(id),\n  seq               INTEGER NOT NULL,\n  name              TEXT NOT NULL,\n  starts_at         INTEGER NOT NULL,\n  ends_at           INTEGER NOT NULL,\n  status            TEXT NOT NULL DEFAULT 'planned'\n                    CHECK (status IN ('planned','active','awaiting_confirm','done')),\n  confirmer_id      TEXT REFERENCES member(id),\n  confirmed_by      TEXT REFERENCES member(id),\n  confirmed_at      INTEGER,\n  UNIQUE (project_id, seq),\n  CHECK ((status = 'done') = (confirmed_by IS NOT NULL))\n);\n\nCREATE TABLE project_phase_target (      -- [P2]\n  id                TEXT PRIMARY KEY,\n  phase_id          TEXT NOT NULL REFERENCES project_phase(id),\n  metric_id         TEXT REFERENCES project_metric(id),\n  description       TEXT NOT NULL,\n  target_value      REAL,\n  verifier_human_id TEXT NOT NULL REFERENCES member(id)\n);\n\nCREATE TABLE project_phase_check (       -- [P2] 勾选只是记录\n  id                TEXT PRIMARY KEY,\n  phase_id          TEXT NOT NULL REFERENCES project_phase(id),\n  label             TEXT NOT NULL,\n  checked           INTEGER NOT NULL DEFAULT 0,\n  checked_by        TEXT REFERENCES member(id),\n  checked_at        INTEGER\n);\n\nCREATE TABLE project_review (            -- [P2]\n  id                TEXT PRIMARY KEY,\n  project_id        TEXT NOT NULL REFERENCES project(id),\n  kind              TEXT NOT NULL CHECK (kind IN ('weekly','monthly','quarterly','phase')),\n  period_start      INTEGER NOT NULL,\n  period_end        INTEGER NOT NULL,\n  target_version_id TEXT NOT NULL REFERENCES project_target_version(id),\n  status            TEXT NOT NULL DEFAULT 'draft'\n                    CHECK (status IN ('draft','awaiting_confirm','confirmed')),\n  conclusion_text   TEXT,\n  confirmer_id      TEXT REFERENCES member(id),\n  confirmed_by      TEXT REFERENCES member(id),\n  confirmed_at      INTEGER,\n  UNIQUE (project_id, kind, period_start),\n  CHECK ((status = 'confirmed') = (confirmed_by IS NOT NULL))\n);\n\nCREATE TABLE project_review_metric (     -- [P2] 复盘冻结快照；缺数只能是 unknown\n  review_id         TEXT NOT NULL REFERENCES project_review(id),\n  metric_id         TEXT NOT NULL REFERENCES project_metric(id),\n  target_value      REAL,\n  actual_value      REAL,\n  verdict           TEXT NOT NULL CHECK (verdict IN ('met','missed','unknown')),\n  evidence_ref      TEXT,\n  PRIMARY KEY (review_id, metric_id),\n  CHECK (actual_value IS NOT NULL OR verdict = 'unknown')\n);\n\nCREATE TABLE activity_daily (            -- [P2] 热力图日聚合，只由 rollup 作业幂等重算\n  member_id         TEXT NOT NULL REFERENCES member(id),\n  date              TEXT NOT NULL,\n  runs              INTEGER NOT NULL DEFAULT 0,\n  succeeded         INTEGER NOT NULL DEFAULT 0,\n  failed            INTEGER NOT NULL DEFAULT 0,\n  PRIMARY KEY (member_id, date)\n);\n\nCREATE TRIGGER trg_review_metric_unknown BEFORE INSERT ON project_review_metric\nWHEN NEW.verdict <> 'unknown' AND EXISTS (\n  SELECT 1 FROM project_metric m WHERE m.id = NEW.metric_id\n     AND (m.calculator_key IS NULL OR m.source_kind IS NULL))\nBEGIN SELECT RAISE(ABORT, 'DATA_STALE: metric without calculator or source can only be unknown'); END;\n"

package/src/store/schema/004_team.sql.ts

@@ -1,50 +0,0 @@
-// 手工编写的增量迁移（v4）：项目群的多 bot 协作。
-//
-// 1. `member.scope_project_id`：临时 bot 只属于一个项目群，成员列表默认不显示；
-// 2. `project_participant`：手动拉进群 / 自动创建的临时 bot，移除用软删（removed_at）；
-// 3. `project_message`：群聊合并记录。每个参与者仍各有自己的宿主会话，
-//    这里只存「谁在什么时候说了什么」，不把整份会话日志抄一遍；
-// 4. `chat_cursor`：每个会话已合并到哪条事件 seq，避免重复。
-export const TEAM_SCHEMA_META = {
-  tableNames: ['project_participant', 'project_message', 'chat_cursor'],
-  note: 'v4 项目群团队：participants / merged messages / session cursor',
-} as const
-
-export const TEAM_SCHEMA_SQL = `-- [P4] 临时 bot 的归属项目；NULL = 常规成员
-ALTER TABLE member ADD COLUMN scope_project_id TEXT;
-
-CREATE TABLE project_participant (       -- [P4] 项目群成员（不包含推进 bot，它在 project.coordinator_id）
-  project_id        TEXT NOT NULL REFERENCES project(id),
-  member_id         TEXT NOT NULL REFERENCES member(id),
-  kind              TEXT NOT NULL CHECK (kind IN ('member','temp')),
-  brief             TEXT NOT NULL DEFAULT '',
-  added_by          TEXT NOT NULL REFERENCES member(id),
-  added_at          INTEGER NOT NULL,
-  removed_by        TEXT REFERENCES member(id),
-  removed_at        INTEGER,
-  PRIMARY KEY (project_id, member_id)
-);
-
-CREATE INDEX idx_project_participant_active ON project_participant(project_id) WHERE removed_at IS NULL;
-
-CREATE TABLE project_message (           -- [P4] 群聊合并记录
-  id            TEXT PRIMARY KEY,
-  project_id    TEXT NOT NULL REFERENCES project(id),
-  author_kind   TEXT NOT NULL CHECK (author_kind IN ('human','bot','system')),
-  author_id     TEXT NOT NULL,
-  author_name   TEXT NOT NULL,
-  text          TEXT NOT NULL,
-  at            INTEGER NOT NULL,
-  kind          TEXT NOT NULL DEFAULT 'chat' CHECK (kind IN ('chat','mention','system')),
-  to_member_id  TEXT,
-  session_id    TEXT
-);
-
-CREATE INDEX idx_project_message_project ON project_message(project_id, at, id);
-
-CREATE TABLE chat_cursor (               -- [P4] 会话事件已合并到哪一条
-  session_id  TEXT PRIMARY KEY,
-  project_id  TEXT NOT NULL REFERENCES project(id),
-  last_seq    INTEGER NOT NULL DEFAULT 0
-);
-`

package/src/store/schema/005_target_check.sql.ts

@@ -1,22 +0,0 @@
-// 增量迁移（v5）：阶段目标的「提交检验」记录。
-//
-// 一个阶段目标可以被反复检验（项目经理提交），每次留下：谁、什么时候、结果、报告链接、说明。
-// 原来的 project_phase_check 只是勾选清单，没有提交人与报告，无法承载这条业务记录。
-export const TARGET_CHECK_SCHEMA_META = {
-  tableNames: ['project_phase_target_check'],
-  note: 'v5 阶段目标检验记录（submitted_by / result / report_url）',
-} as const
-
-export const TARGET_CHECK_SCHEMA_SQL = `CREATE TABLE project_phase_target_check (   -- [P5] 阶段目标的检验提交
-  id            TEXT PRIMARY KEY,
-  project_id    TEXT NOT NULL REFERENCES project(id),
-  target_id     TEXT NOT NULL REFERENCES project_phase_target(id),
-  submitted_by  TEXT NOT NULL REFERENCES member(id),
-  submitted_at  INTEGER NOT NULL,
-  result        TEXT NOT NULL CHECK (result IN ('met','missed','unknown')),
-  report_url    TEXT,
-  note          TEXT NOT NULL DEFAULT ''
-);
-
-CREATE INDEX idx_phase_target_check_target ON project_phase_target_check(target_id, submitted_at);
-`

package/src/store/schema/006_target_flow.sql.ts

@@ -1,19 +0,0 @@
-// 增量迁移（v6）：阶段目标的「说明 / 检验提交与审批」字段。
-//
-// - `project_phase_target.detail`：目标详情（计算方式与验收要求）；
-// - `project_phase_target_check`：补上审批人、状态、审批决定与摘要。提交检验 = 申请审批，
-//   审批通过后目标才算达成（审批本身复用 approval 表，subject_kind = 'target_change'）。
-export const TARGET_FLOW_SCHEMA_META = {
-  tableNames: [],
-  note: 'v6 阶段目标说明 + 检验提交的审批字段（ALTER TABLE）',
-} as const
-
-export const TARGET_FLOW_SCHEMA_SQL = `ALTER TABLE project_phase_target ADD COLUMN detail TEXT NOT NULL DEFAULT '';
-
-ALTER TABLE project_phase_target_check ADD COLUMN approver_id TEXT REFERENCES member(id);
-ALTER TABLE project_phase_target_check ADD COLUMN summary TEXT NOT NULL DEFAULT '';
-ALTER TABLE project_phase_target_check ADD COLUMN status TEXT NOT NULL DEFAULT 'pending';
-ALTER TABLE project_phase_target_check ADD COLUMN decided_by TEXT REFERENCES member(id);
-ALTER TABLE project_phase_target_check ADD COLUMN decided_at INTEGER;
-ALTER TABLE project_phase_target_check ADD COLUMN decision_note TEXT NOT NULL DEFAULT '';
-`

package/src/store/schema/007_project_delete.sql.ts

@@ -1,17 +0,0 @@
-// 手工编写的增量迁移（v7）：归档项目可以「删除」。
-//
-// 设计取舍：这里不是物理删除。HAMS 的证据和审计是追加式的，硬删会绕开
-// `trg_evidence_no_delete` 与审计留痕；因此「删除」= 在项目上打 removed 标记，
-// 列表/详情/群聊不再出现，同时把该项目的工作项解绑为「无项目」继续留在任务里。
-// 需要物理清库时另行走运维工具，不在界面里提供。
-export const PROJECT_DELETE_SCHEMA_META = {
-  tableNames: [] as const,
-  alteredTables: ['project'] as const,
-  note: 'v7 项目软删除：project.deleted_at / deleted_by；工作项解绑保留',
-} as const
-
-export const PROJECT_DELETE_SCHEMA_SQL = `ALTER TABLE project ADD COLUMN deleted_at INTEGER;
-ALTER TABLE project ADD COLUMN deleted_by TEXT REFERENCES member(id);
--- 项目名有 UNIQUE 约束：软删时把名字改成墓碑，原值留在这里，名字可复用。
-ALTER TABLE project ADD COLUMN deleted_name TEXT;
-`

package/src/store/schema/008_memory.sql.ts

@@ -1,47 +0,0 @@
-// 手工编写的增量迁移（v8）：项目记忆 + bot 记忆。
-//
-// 项目记忆是「推进过程中值得留下来的话」：决策、偏好、教训、事实，以及 bot 能力类
-// 经验。它和知识库（kb_doc）不同：知识库是成篇文档，记忆是短句 + 来源，默认按项目
-// 隔离；能力类记忆会镜像一份到 `bot_memory`，在对应 bot 的会话上下文里注入。
-//
-// 只追加、可归档；不删外键数据，项目软删时记忆随项目一起隐藏。
-export const MEMORY_SCHEMA_META = {
-  tableNames: ['project_memory', 'bot_memory'] as const,
-  alteredTables: [] as const,
-  note: 'v8 项目记忆：project_memory + bot 镜像 bot_memory',
-} as const
-
-export const MEMORY_SCHEMA_SQL = `CREATE TABLE project_memory (           -- [P4] 项目推进过程中收集的记忆
-  id            TEXT PRIMARY KEY,
-  project_id    TEXT NOT NULL REFERENCES project(id),
-  kind          TEXT NOT NULL CHECK (kind IN ('fact','decision','preference','lesson','capability')),
-  title         TEXT NOT NULL,
-  body          TEXT NOT NULL,
-  origin        TEXT NOT NULL CHECK (origin IN ('auto','manual','tool')),
-  status        TEXT NOT NULL DEFAULT 'active' CHECK (status IN ('active','archived')),
-  member_id     TEXT REFERENCES member(id),       -- 能力类记忆归属的 bot；其它类型为 NULL
-  source_ref    TEXT,                             -- message:<id> / manual / tool
-  dedupe_key    TEXT NOT NULL,
-  created_by    TEXT NOT NULL REFERENCES member(id),
-  created_at    INTEGER NOT NULL,
-  updated_at    INTEGER NOT NULL,
-  revision      INTEGER NOT NULL DEFAULT 1,
-  UNIQUE (project_id, dedupe_key)
-);
-
-CREATE INDEX idx_project_memory_project ON project_memory(project_id, status, created_at);
-
-CREATE TABLE bot_memory (             -- [P4] 能力类记忆同步给 bot 的快照
-  id            TEXT PRIMARY KEY,
-  member_id     TEXT NOT NULL REFERENCES member(id),
-  project_id    TEXT NOT NULL REFERENCES project(id),
-  memory_id     TEXT NOT NULL REFERENCES project_memory(id),
-  kind          TEXT NOT NULL,
-  title         TEXT NOT NULL,
-  body          TEXT NOT NULL,
-  created_at    INTEGER NOT NULL,
-  UNIQUE (member_id, memory_id)
-);
-
-CREATE INDEX idx_bot_memory_member ON bot_memory(member_id, created_at);
-`

package/src/store/schema/generate-projects.mjs

@@ -1,16 +0,0 @@
-// Generate migration 3 from the authoritative DDL; no hand-copied table definitions.
-// Run: node src/store/schema/generate-projects.mjs [--check]
-import { readFileSync, writeFileSync } from 'node:fs'
-import { createHash } from 'node:crypto'
-import { parseSchema } from '../../../scripts/split-schema.mjs'
-const authority = new URL('../../../docs/schema-2026-11-14.sql', import.meta.url)
-const text = readFileSync(authority, 'utf8')
-const tables = ['project_phase', 'project_phase_target', 'project_phase_check', 'project_review', 'project_review_metric', 'activity_daily', 'member_version_skill']
-const statements = parseSchema(text).filter(s => tables.some(t => new RegExp(`^(?:CREATE TABLE ${t}\\b|CREATE (?:UNIQUE )?INDEX \\w+ ON ${t}\\b|CREATE TRIGGER \\w+[\\s\\S]*?\\bON ${t}\\b)`).test(s.text)))
-const sql = statements.map(s => s.text).join('\n\n') + '\n'
-const sha = createHash('sha256').update(text).digest('hex')
-const content = `// Generated by node src/store/schema/generate-projects.mjs; source docs/schema-2026-11-14.sql\nexport const PROJECTS_SCHEMA_META = ${JSON.stringify({authority: 'docs/schema-2026-11-14.sql', authoritySha256: sha, tableNames: tables})} as const\nexport const PROJECTS_SCHEMA_SQL = ${JSON.stringify(sql)}\n`
-const target = new URL('./003_projects.sql.ts', import.meta.url)
-if (process.argv.includes('--check')) {
-  if (readFileSync(target, 'utf8') !== content) throw new Error('Migration 3 differs from authoritative DDL')
-} else writeFileSync(target, content)

package/src/store/seed.ts

@@ -1,114 +0,0 @@
-/**
- * 种子与元数据。
- *
- * v1 的 DDL 已经带了两条基线种子：唯一的系统主体（member.id='system'）与 36 条状态转换
- * 白名单。本文件负责其余「必须有、但可以缺省补写」的元数据，原则只有一条：
- * **只补缺失，不覆盖已有值**——重启不能把 runtime_epoch 或工作区指针重置。
- *
- * 岗位能力矩阵属于业务待确认项（status §5），不在这里造数据。
- */
-import type { DatabaseSync } from 'node:sqlite'
-import { transaction, userVersion, StoreError } from './db.ts'
-
-export const META_KEYS = [
-  'schema_version',
-  'runtime_epoch',
-  'primary_workspace_id',
-  'last_tick_at',
-  'bootstrapped_at',
-] as const
-
-export type MetaKey = (typeof META_KEYS)[number]
-
-export class SeedError extends StoreError {
-  constructor(message: string, code = 'SEED_INVALID') {
-    super(code, message)
-    this.name = 'SeedError'
-  }
-}
-
-export function readMeta(db: DatabaseSync): Record<string, string> {
-  const rows = db.prepare('SELECT key, value FROM hams_meta').all() as { key: string; value: string }[]
-  const meta: Record<string, string> = {}
-  for (const row of rows) meta[row.key] = row.value
-  return meta
-}
-
-export interface SeedOptions {
-  now?: number
-}
-
-/**
- * 补齐 hams_meta 的缺省键（幂等）。schema_version 永远与 PRAGMA user_version 对齐。
- */
-export function ensureMetaDefaults(db: DatabaseSync, options: SeedOptions = {}): Record<string, string> {
-  const now = options.now ?? Date.now()
-  const defaults: Record<MetaKey, string> = {
-    schema_version: String(userVersion(db)),
-    runtime_epoch: '0',
-    primary_workspace_id: '',
-    last_tick_at: '0',
-    bootstrapped_at: String(now),
-  }
-
-  return transaction(db, () => {
-    const insert = db.prepare('INSERT OR IGNORE INTO hams_meta (key, value) VALUES (?, ?)')
-    for (const key of META_KEYS) insert.run(key, defaults[key])
-    const update = db.prepare('UPDATE hams_meta SET value = ? WHERE key = ?')
-    update.run(String(userVersion(db)), 'schema_version')
-    return readMeta(db)
-  })
-}
-
-/** 宿主启动代次 +1：与业务代次无关，只用于识别上个进程留下的运行。 */
-export function bumpRuntimeEpoch(db: DatabaseSync): number {
-  return transaction(db, () => {
-    const row = db.prepare("SELECT value FROM hams_meta WHERE key = 'runtime_epoch'").get() as
-      | { value: string }
-      | undefined
-    const current = Number(row?.value ?? 0)
-    const next = (Number.isFinite(current) && current >= 0 ? current : 0) + 1
-    db.prepare(
-      `INSERT INTO hams_meta (key, value) VALUES ('runtime_epoch', ?)
-         ON CONFLICT(key) DO UPDATE SET value = excluded.value`,
-    ).run(String(next))
-    return next
-  })
-}
-
-export function readRuntimeEpoch(db: DatabaseSync): number {
-  const row = db.prepare("SELECT value FROM hams_meta WHERE key = 'runtime_epoch'").get() as
-    | { value: string }
-    | undefined
-  return Number(row?.value ?? 0)
-}
-
-export interface SeedSummary {
-  systemMember: boolean
-  transitions: number
-  tables: number
-}
-
-/**
- * 基线种子核对：系统主体必须唯一存在，状态白名单必须正好 36 条。
- * 迁移完成后立刻调用；不满足说明 DDL 被改坏，拒绝接流量。
- */
-export function assertBaselineSeed(db: DatabaseSync): SeedSummary {
-  const system = db
-    .prepare("SELECT COUNT(*) AS c FROM member WHERE kind = 'system' AND id = 'system'")
-    .get() as { c: number }
-  const transitions = (db.prepare('SELECT COUNT(*) AS c FROM work_item_transition').get() as { c: number }).c
-  const tables = (
-    db
-      .prepare("SELECT COUNT(*) AS c FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'")
-      .get() as { c: number }
-  ).c
-
-  if (Number(system.c) !== 1) {
-    throw new SeedError(`系统主体应唯一存在一行，实际 ${system.c} 行；拒绝接流量`)
-  }
-  if (Number(transitions) !== 36) {
-    throw new SeedError(`状态转换白名单应有 36 条，实际 ${transitions} 条；拒绝接流量`)
-  }
-  return { systemMember: true, transitions: Number(transitions), tables: Number(tables) }
-}