ai-growth 1.1.0

package/scripts/install.sh

@@ -0,0 +1,291 @@
+#!/usr/bin/env bash
+# AI Growth — 一键安装（macOS）
+#
+# 核心原则：**开发与生产用同一条全局命令，数据始终在 ~/.ai-growth**。
+# CLI / MCP / daemon / 面板 都指向"全局安装的那一份"代码，所以更新 = 替换全局包。
+#
+# 完成：环境检查 → 依赖 → 构建 → 全局安装 → 数据库迁移
+#      → launchd 常驻服务（指向全局 CLI）→ MCP 配置 → Agent 入口说明 → doctor
+#
+# 用法：
+#   ./scripts/install.sh              # 默认：npm link（开发态）+ 安装 Skill
+#   ./scripts/install.sh --global     # 生产态：npm pack + npm install -g（实体包，与检出解耦）
+#   ./scripts/install.sh --with-mcp   # 额外把 MCP 写入 ~/.workbuddy/mcp.json（会先备份）
+#   ./scripts/install.sh --no-skill   # 不安装 Skill 到 ~/.workbuddy/skills/
+#   ./scripts/install.sh --no-daemon  # 不安装 launchd 常驻服务
+#   ./scripts/install.sh --device-lan # 常驻服务以局域网模式跑（AI Passport 设备要从 Wi-Fi 访问）
+
+set -euo pipefail
+
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DATA_DIR="${AI_GROWTH_DATA_DIR:-$HOME/.ai-growth}"
+PLIST_LABEL="com.lairey.ai-growth.daemon"
+PLIST_DEST="$HOME/Library/LaunchAgents/${PLIST_LABEL}.plist"
+NODE_BIN="$(command -v node || true)"
+NPM_GLOBAL_PREFIX="$(npm prefix -g 2>/dev/null || true)"
+GLOBAL_BIN="$NPM_GLOBAL_PREFIX/bin"
+GLOBAL_CLI="$NPM_GLOBAL_PREFIX/lib/node_modules/ai-growth/dist/cli/main.js"
+
+MODE="link"          # link | global
+WITH_MCP=0
+WITH_SKILL=1
+WITH_DAEMON=1
+DEVICE_LAN=0         # 1 = daemon 以局域网模式常驻（AI Passport 设备需要）
+for arg in "$@"; do
+  case "$arg" in
+    --global) MODE="global" ;;
+    --link) MODE="link" ;;
+    --with-mcp) WITH_MCP=1 ;;
+    --no-skill) WITH_SKILL=0 ;;
+    --no-daemon) WITH_DAEMON=0 ;;
+    --device-lan) DEVICE_LAN=1 ;;
+    --no-device-lan) DEVICE_LAN=0 ;;
+    *) echo "未知参数：$arg"; exit 1 ;;
+  esac
+done
+
+step() { printf "\n\033[1;34m▶ %s\033[0m\n" "$1"; }
+ok()   { printf "  \033[0;32m✓\033[0m %s\n" "$1"; }
+warn() { printf "  \033[0;33m!\033[0m %s\n" "$1"; }
+die()  { printf "  \033[0;31m✗\033[0m %s\n" "$1"; exit 1; }
+
+# ---------------------------------------------------------------- 1. 依赖检查
+step "1/9 检查运行环境"
+[ -n "$NODE_BIN" ] || die "未找到 node，请先安装 Node.js >= 20（https://nodejs.org）"
+NODE_MAJOR="$("$NODE_BIN" -p 'process.versions.node.split(".")[0]')"
+[ "$NODE_MAJOR" -ge 20 ] || die "Node 版本过低（当前 $("$NODE_BIN" -v)），需要 >= 20"
+ok "node $("$NODE_BIN" -v) @ $NODE_BIN"
+command -v npm >/dev/null || die "未找到 npm"
+ok "npm $(npm -v)"
+[ -n "$NPM_GLOBAL_PREFIX" ] || die "无法确定 npm 全局前缀（npm prefix -g 失败）"
+ok "npm 全局前缀：$NPM_GLOBAL_PREFIX"
+case ":$PATH:" in
+  *":$GLOBAL_BIN:"*) ok "全局 bin 已在 PATH 中（终端里可直接用 ai-growth）" ;;
+  *) warn "全局 bin 不在当前 PATH：$GLOBAL_BIN"
+     warn "请在 ~/.zshrc 加：export PATH=\"$GLOBAL_BIN:\$PATH\"（你的交互式 shell 可能已配好）" ;;
+esac
+if [[ "$(uname -s)" != "Darwin" ]]; then
+  warn "当前非 macOS：daemon 自启动将跳过（launchd 仅限 macOS）"
+  WITH_DAEMON=0
+fi
+
+# ---------------------------------------------------------------- 2. 安装依赖
+step "2/9 安装依赖"
+cd "$PROJECT_DIR"
+need_install=0
+[ -d node_modules ] || need_install=1
+# 关键依赖缺失也要补装（避免"目录在但内容不全"的假象）
+for dep in better-sqlite3 @modelcontextprotocol/sdk zod typescript; do
+  [ -e "node_modules/$dep" ] || need_install=1
+done
+
+if [ "$need_install" -eq 0 ]; then
+  ok "依赖已就绪（node_modules 完整）"
+else
+  # npm 偶发 "Tracker idealTree already exists"（并发/缓存态），重试一次即可
+  if npm install --no-audit --no-fund; then
+    ok "依赖安装完成"
+  else
+    warn "npm install 首次失败，清理状态后重试…"
+    rm -rf node_modules/.package-lock.json
+    if npm install --no-audit --no-fund; then
+      ok "依赖安装完成（重试成功）"
+    else
+      die "依赖安装失败。请手动排查：cd \"$PROJECT_DIR\" && npm install"
+    fi
+  fi
+fi
+# 装完再确认一次，不允许带着残缺依赖继续
+for dep in better-sqlite3 @modelcontextprotocol/sdk zod; do
+  [ -e "node_modules/$dep" ] || die "依赖缺失：${dep}（请手动运行 npm install）"
+done
+
+# ---------------------------------------------------------------- 3. 构建
+step "3/9 构建 TypeScript"
+npm run build >/dev/null
+ok "构建产物：dist/"
+
+# ---------------------------------------------------------------- 3.5 全局安装
+step "4/9 全局安装（CLI / MCP / daemon 都指向这一份）"
+if [ "$MODE" = "global" ]; then
+  TGZ="$(npm pack --silent | tail -1)"
+  [ -f "$PROJECT_DIR/$TGZ" ] || die "npm pack 失败"
+  npm install -g "$PROJECT_DIR/$TGZ" >/dev/null 2>&1 || die "npm install -g 失败"
+  rm -f "$PROJECT_DIR/$TGZ"
+  ok "生产态：已全局安装实体包（与源码检出解耦）"
+else
+  npm link >/dev/null 2>&1 || die "npm link 失败"
+  ok "开发态：全局命令已软链到本检出（npm link）"
+fi
+# 用全局 CLI 自我确认（这也是 daemon / MCP 将要使用的那一份）
+if [ -x "$GLOBAL_CLI" ] || [ -f "$GLOBAL_CLI" ]; then
+  V="$("$NODE_BIN" "$GLOBAL_CLI" version --json 2>/dev/null | "$NODE_BIN" -e "let s='';process.stdin.on('data',c=>s+=c).on('end',()=>{try{console.log(JSON.parse(s).data.version)}catch{console.log('?')}})" 2>/dev/null || echo '?')"
+  ok "全局入口可用：${GLOBAL_CLI}（版本 ${V}）"
+else
+  warn "全局入口未就位：$GLOBAL_CLI"
+fi
+
+# ---------------------------------------------------------------- 5. 数据目录 + 迁移
+step "5/9 初始化数据库（数据始终在 ${DATA_DIR}，与代码解耦）"
+mkdir -p "$DATA_DIR"
+AI_GROWTH_DATA_DIR="$DATA_DIR" "$NODE_BIN" "$GLOBAL_CLI" migrate 2>/dev/null \
+  || AI_GROWTH_DATA_DIR="$DATA_DIR" "$NODE_BIN" dist/db/cli.js migrate
+
+# ---------------------------------------------------------------- 6. launchd
+step "6/9 安装常驻服务（launchd → 指向全局 CLI）"
+if [ "$WITH_DAEMON" -eq 1 ]; then
+  mkdir -p "$HOME/Library/LaunchAgents"
+  TMP_PLIST="$(mktemp)"
+  sed -e "s|__NODE_BIN__|${NODE_BIN}|g" \
+      -e "s|__AI_GROWTH_CLI__|${GLOBAL_CLI}|g" \
+      -e "s|__DATA_DIR__|${DATA_DIR}|g" \
+      -e "s|__AI_GROWTH_DEVICE_LAN__|${DEVICE_LAN}|g" \
+      "$PROJECT_DIR/launchd/${PLIST_LABEL}.plist" > "$TMP_PLIST"
+  cp "$TMP_PLIST" "$PLIST_DEST"
+  rm -f "$TMP_PLIST"
+  ok "plist 已写入：$PLIST_DEST"
+  ok "它调用的是全局 CLI：$GLOBAL_CLI serve（更新全局包即更新 daemon）"
+  if [ "$DEVICE_LAN" -eq 1 ]; then
+    ok "已开启设备局域网访问（AI_GROWTH_DEVICE_LAN=1）：AI Passport 可从 Wi-Fi 访问；令牌用 ai-growth device 查看"
+  else
+    warn "未开启设备局域网访问：AI Passport 设备连不上（需要时重跑 ./scripts/install.sh --device-lan）"
+  fi
+
+  # 先卸载可能存在的旧实例，保证幂等。
+  # 注意：bootout 是异步的，紧接着 bootstrap 会偶发失败（服务尚未完全拆除），
+  # 因此必须 sleep + 重试 —— 否则重装会把本来在跑的服务搞停。
+  UID_NUM="$(id -u)"
+  launchctl bootout "gui/$UID_NUM/$PLIST_LABEL" >/dev/null 2>&1 || true
+  launchctl unload "$PLIST_DEST" >/dev/null 2>&1 || true
+  sleep 1
+
+  LOADED=0
+  for attempt in 1 2 3; do
+    # 现代方式（macOS 11+）
+    if launchctl bootstrap "gui/$UID_NUM" "$PLIST_DEST" >/dev/null 2>&1; then LOADED=1; break; fi
+    # 旧版回退
+    if launchctl load "$PLIST_DEST" >/dev/null 2>&1 && launchctl list 2>/dev/null | grep -q "$PLIST_LABEL"; then LOADED=1; break; fi
+    sleep 2
+  done
+
+  # bootstrap 返回成功不等于进程活着 —— 直接看它在不在跑
+  if [ "$LOADED" -eq 1 ]; then
+    sleep 2
+    if pgrep -f "ai-growth/dist/cli/main.js serve" >/dev/null 2>&1; then
+      ok "daemon 已加载并运行（开机自动恢复）"
+    else
+      LOADED=0
+    fi
+  fi
+
+  if [ "$LOADED" -eq 0 ]; then
+    warn "launchd 未能启动服务（plist 已正确就位，不影响后续开机自启）。"
+    printf "  \033[0;33m?\033[0m 三种方式任选：\n"
+    printf "     · 重启电脑：~/Library/LaunchAgents/ 里的服务会在登录时自动加载\n"
+    printf "     · 立刻生效（在「终端」执行）：\n\n"
+    printf "         launchctl bootout gui/%s/%s 2>/dev/null; launchctl bootstrap gui/%s \"%s\"\n\n" "$UID_NUM" "$PLIST_LABEL" "$UID_NUM" "$PLIST_DEST"
+    printf "     · 或先不管它 —— 手动前台跑：ai-growth serve\n\n"
+    printf "  \033[0;33m?\033[0m 未跑 daemon 不影响核心闭环：Agent 每次进入会调用跨天检查，\n"
+    printf "     跨天状态依旧正确；只有「定时提醒」需要它常驻。\n"
+  fi
+else
+  warn "已跳过 daemon 安装。手动启动：ai-growth serve"
+fi
+
+# ---------------------------------------------------------------- 7. MCP 配置
+step "7/9 MCP 配置（指向全局安装，不指向开发目录）"
+SNIPPET="$PROJECT_DIR/mcp-config.snippet.json"
+MCP_SERVER_JS="$NPM_GLOBAL_PREFIX/lib/node_modules/ai-growth/dist/mcp/server.js"
+cat > "$SNIPPET" <<JSON
+{
+  "mcpServers": {
+    "ai-growth": {
+      "command": "${NODE_BIN}",
+      "args": ["${MCP_SERVER_JS}"],
+      "env": { "AI_GROWTH_DATA_DIR": "${DATA_DIR}" }
+    }
+  }
+}
+JSON
+ok "片段已写入：$SNIPPET"
+ok "MCP 入口：$MCP_SERVER_JS"
+
+if [ "$WITH_MCP" -eq 1 ]; then
+  MCP_JSON="$HOME/.workbuddy/mcp.json"
+  mkdir -p "$(dirname "$MCP_JSON")"
+  if [ -f "$MCP_JSON" ]; then
+    cp "$MCP_JSON" "${MCP_JSON}.bak.$(date +%Y%m%d%H%M%S)"
+    ok "已备份原配置"
+  else
+    echo '{"mcpServers":{}}' > "$MCP_JSON"
+  fi
+  "$NODE_BIN" - "$MCP_JSON" "$NODE_BIN" "$MCP_SERVER_JS" "$DATA_DIR" <<'NODE'
+const [file, nodeBin, serverJs, dataDir] = process.argv.slice(2);
+const fs = require('fs');
+const cfg = JSON.parse(fs.readFileSync(file, 'utf8'));
+cfg.mcpServers = cfg.mcpServers || {};
+cfg.mcpServers['ai-growth'] = {
+  command: nodeBin,
+  args: [serverJs],
+  env: { AI_GROWTH_DATA_DIR: dataDir },
+};
+fs.writeFileSync(file, JSON.stringify(cfg, null, 2));
+console.log('  \x1b[0;32m✓\x1b[0m 已合并进 ' + file);
+NODE
+  warn "新 MCP 不会自动激活：请在连接器管理页右上角「自定义连接器」中对该服务点击「信任」"
+else
+  warn "未自动写入 Agent 配置（安全默认）。两种方式二选一："
+  echo "     a) 重跑：./scripts/install.sh --with-mcp"
+  echo "     b) 手动把 $SNIPPET 的内容合并进 ~/.workbuddy/mcp.json"
+fi
+
+# ---------------------------------------------------------------- 8. Agent 入口
+step "8/9 Agent 入口与 Skill"
+echo "   仓库根目录有三个 agent 可识别文件："
+echo "     $PROJECT_DIR/AGENTS.md      ← Agent 入口（安装/接入/能力/铁律）"
+echo "     $PROJECT_DIR/llms.txt       ← 精简机器可读索引"
+echo "     $PROJECT_DIR/server.json    ← MCP Registry 清单"
+echo ""
+
+# Skill 决定 Agent「什么时候」用这套系统。不装的话，Agent 不知道何时该走 AI Growth。
+SKILL_DEST="$HOME/.workbuddy/skills/ai-growth"
+if [ "$WITH_SKILL" -eq 1 ]; then
+  mkdir -p "$SKILL_DEST"
+  cp "$PROJECT_DIR/SKILL.md" "$SKILL_DEST/SKILL.md"
+  # frontmatter 的 name+description 是 always-in-context 的元数据，Agent 靠它路由
+  if head -1 "$SKILL_DEST/SKILL.md" | grep -q '^---$'; then
+    ok "Skill 已安装：$SKILL_DEST/SKILL.md（含 frontmatter，可被 Agent 识别触发时机）"
+  else
+    warn "Skill 已复制，但缺少 frontmatter（name/description），Agent 可能不会自动触发"
+  fi
+  echo "     移除：rm -rf \"$SKILL_DEST\""
+else
+  warn "已跳过 Skill 安装（--no-skill）。手动安装："
+  echo "     mkdir -p \"$SKILL_DEST\" && cp \"$PROJECT_DIR/SKILL.md\" \"$SKILL_DEST/\""
+fi
+echo ""
+if [ -x "$GLOBAL_BIN/ai-growth" ] || [ -f "$GLOBAL_BIN/ai-growth" ]; then
+  ok "全局命令就绪：ai-growth（在终端里可直接用）"
+  echo "     自检：ai-growth where       # 当前跑的是哪一份、怎么更新"
+  echo "     Agent 自举：ai-growth agent-info --json"
+else
+  warn "全局命令未就绪，检查 $GLOBAL_BIN 是否在 PATH"
+fi
+
+# ---------------------------------------------------------------- 9. doctor
+step "9/9 运行 doctor 验证"
+bash "$PROJECT_DIR/scripts/doctor.sh" || warn "doctor 报告了问题，请查看上方输出"
+
+printf "\n\033[1;32m安装完成。\033[0m\n"
+printf "  代码位置：%s（%s）\n" "$GLOBAL_CLI" "$([ "$MODE" = global ] && echo '生产态：实体包' || echo '开发态：npm link 到本检出')"
+printf "  数据位置：%s（更新代码不会动它）\n" "$DATA_DIR"
+printf "\n  更新方式：\n"
+if [ "$MODE" = global ]; then
+  printf "    npm install -g ai-growth@latest && ai-growth migrate\n"
+else
+  printf "    git pull && npm install && npm run build    # 全局命令自动指向新代码\n"
+fi
+printf "    launchctl kickstart -k gui/$(id -u)/%s   # 让 daemon 加载新代码\n" "$PLIST_LABEL"
+printf "\n  下一步：打开你的 Agent，让它加载 SKILL.md 并连接 ai-growth MCP，\n"
+
+printf "          然后说一句「开启今日任务」——首次会主动开始访谈。\n\n"

package/scripts/preview-cards.mjs

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+/**
+ * 把设备会显示的所有卡面拼成一张「对照图」，用于设计评审。
+ *
+ * 为什么需要它：
+ *   设备卡只有 240×320，单独看一张很难判断整体视觉是否成立（层级、留白、字号、
+ *   状态色的可辨度）。把「开机/离线/未配置」三张固件内置兜底卡 + 运行时五种卡面
+ *   放在同一张图上按 2× 像素放大对照，就能一眼看出是否成体系。
+ *
+ * 它渲染的是**与运行时完全相同**的 buildCardHtml()，不是另外画的示意图 ——
+ * 所以这张图里看到什么，设备上就是什么（除了被放大 2 倍）。
+ *
+ * 用法：
+ *   npm run build && node scripts/preview-cards.mjs [--out <png路径>] [--scale 2]
+ * 默认输出：<项目>/.workbuddy/previews/device-cards.png
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const root = resolve(here, '..');
+const distDir = join(root, 'dist', 'device');
+
+function argValue(flag, fallback) {
+  const i = process.argv.indexOf(flag);
+  return i >= 0 && process.argv[i + 1] ? process.argv[i + 1] : fallback;
+}
+
+const outPath = resolve(argValue('--out', join(root, '.workbuddy', 'previews', 'device-cards.png')));
+const scale = Math.max(1, Math.min(3, Number(argValue('--scale', '2')) || 2));
+
+if (!existsSync(join(distDir, 'card.js'))) {
+  console.error('未找到 dist/device/card.js —— 先跑 `npm run build`。');
+  process.exit(2);
+}
+
+const { buildCardHtml } = await import(join(distDir, 'card.js'));
+const { screenshotPng, CARD_WIDTH, CARD_HEIGHT } = await import(join(distDir, 'render.js'));
+
+const ITEMS = [
+  { id: 'a1', kind: 'MAIN_QUEST', title: '实现最小 Agent Memory Demo', status: 'PLANNED', done: false, minutes: 60, why: 'Memory 是当前阶段的出口标准', completionCriteria: 'demo 能写入并召回' },
+  { id: 'a2', kind: 'DAILY', title: '散步 30 分钟', status: 'COMPLETED', done: true, minutes: 30, why: '保持运动习惯' },
+  { id: 'a3', kind: 'DAILY', title: '读 20 页书', status: 'PLANNED', done: false, minutes: 20 },
+];
+
+const BASE = {
+  dateLabel: '9月20日 周日',
+  dateKey: '2026-09-20',
+  stage: { title: '跑通端到端最小闭环', order: 3, total: 6 },
+  items: ITEMS,
+  doneCount: 1,
+  total: ITEMS.length,
+  battery: 76,
+  facts: { evidence: 14, mainDone: 3 },
+};
+
+const BLANK = { ...BASE, dateLabel: '', dateKey: '', items: [], total: 0, doneCount: 0, battery: null, stage: null };
+
+/** 顺序 = 设备上实际会遇到的顺序：先固件兜底，再服务端正常卡面 */
+const CARDS = [
+  ['固件兜底 · 开机', BLANK, { kind: 'booting', title: '正在连接' }],
+  ['固件兜底 · 离线', BLANK, { kind: 'offline', title: '连不上电脑' }],
+  ['固件兜底 · 未配置', BLANK, { kind: 'setup', title: '还没配置' }],
+  ['运行时 · 今日总览', BASE, { kind: 'overview', title: '今日总览' }],
+  ['运行时 · 主线任务', BASE, { kind: 'task', itemIndex: 0, title: '主线' }],
+  ['运行时 · 已完成的小事', BASE, { kind: 'task', itemIndex: 1, title: '小事' }],
+  ['运行时 · 全部做完', { ...BASE, doneCount: 3, items: ITEMS.map((i) => ({ ...i, done: true, status: 'COMPLETED' })) }, { kind: 'alldone', title: '今天做完了' }],
+  ['运行时 · 今天没排计划', { ...BASE, items: [], total: 0, doneCount: 0, stage: null }, { kind: 'noplan', title: '今天还没排计划' }],
+];
+
+async function renderCard(state, spec) {
+  const html = buildCardHtml(state, spec);
+  return screenshotPng(html, { width: CARD_WIDTH, height: CARD_HEIGHT });
+}
+
+function sheetHtml(entries) {
+  const cols = 4;
+  const cellW = CARD_WIDTH * scale;
+  const imgH = CARD_HEIGHT * scale;
+  const labelH = 26;
+  const gap = 20;
+  const pad = 26;
+  const rows = Math.ceil(entries.length / cols);
+  const w = pad * 2 + cols * cellW + (cols - 1) * gap;
+  const h = pad * 2 + rows * (labelH + imgH) + (rows - 1) * gap;
+
+  const cells = entries.map(([label, png]) => `
+    <figure>
+      <figcaption>${label}</figcaption>
+      <img src="data:image/png;base64,${png.toString('base64')}" alt="${label}">
+    </figure>`).join('');
+
+  return { html: `<!DOCTYPE html><html><head><meta charset="utf-8"><style>
+    *{margin:0;padding:0;box-sizing:border-box}
+    html,body{width:${w}px;height:${h}px;background:#0b0f14;
+      font-family:"PingFang SC","Hiragino Sans GB","Microsoft YaHei",sans-serif;
+      -webkit-font-smoothing:antialiased}
+    .sheet{display:grid;grid-template-columns:repeat(${cols},${cellW}px);gap:${gap}px;padding:${pad}px}
+    figure{display:flex;flex-direction:column;gap:6px}
+    figcaption{height:${labelH - 6}px;line-height:${labelH - 6}px;font-size:13px;color:#9fb6c9;letter-spacing:.2px}
+    img{width:${cellW}px;height:${imgH}px;display:block;border-radius:${30 * scale}px;image-rendering:pixelated;
+      box-shadow:0 0 0 1px rgba(140,190,225,.18),0 10px 28px rgba(0,0,0,.55)}
+  </style></head><body><div class="sheet">${cells}</div></body></html>`, width: w, height: h };
+}
+
+const entries = [];
+for (const [label, state, spec] of CARDS) {
+  entries.push([label, await renderCard(state, spec)]);
+  console.log(`✓ 渲染 ${label}`);
+}
+
+const { html, width, height } = sheetHtml(entries);
+console.log(`… 合成对照图 ${width}×${height}（每张卡放大 ${scale}×）`);
+const sheet = await screenshotPng(html, { width, height });
+
+mkdirSync(dirname(outPath), { recursive: true });
+writeFileSync(outPath, sheet);
+console.log(`\n✓ 对照图：${outPath}`);
+console.log('  这张图里的卡面与运行时 buildCardHtml() 完全同源，只是被像素级放大了。');

package/scripts/reset-dev-data.sh

@@ -0,0 +1,92 @@
+#!/usr/bin/env bash
+# AI Growth — 重置「测试数据」
+#
+# 安全设计（§21 / 附录 C）：
+#   · 默认把当前数据目录**改名备份**而不是删除，绝不静默销毁真实数据。
+#   · 若检测到疑似真实使用痕迹（有已确认 Goal 或较多样本），需要 --force 才继续。
+#
+# 用法：
+#   ./scripts/reset-dev-data.sh            # 备份现有数据 → 建一个干净的新库
+#   ./scripts/reset-dev-data.sh --force    # 跳过"疑似真实数据"的拦截
+#   ./scripts/reset-dev-data.sh --list     # 只查看当前数据概况，不做任何修改
+
+set -uo pipefail
+
+PROJECT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
+DATA_DIR="${AI_GROWTH_DATA_DIR:-$HOME/.ai-growth}"
+NODE_BIN="$(command -v node || true)"
+
+FORCE=0
+case "${1:-}" in
+  --force) FORCE=1 ;;
+  --list) ;;
+  "") ;;
+  *) echo "未知参数：$1"; exit 1 ;;
+esac
+
+ok()   { printf "  \033[0;32m✓\033[0m %s\n" "$1"; }
+warn() { printf "  \033[0;33m!\033[0m %s\n" "$1"; }
+die()  { printf "  \033[0;31m✗\033[0m %s\n" "$1"; exit 1; }
+
+printf "\033[1mAI Growth 数据概况\033[0m\n数据目录：%s\n\n" "$DATA_DIR"
+
+if [ ! -f "$DATA_DIR/growth.db" ]; then
+  warn "尚无数据库，无需重置"
+  exit 0
+fi
+
+[ -n "$NODE_BIN" ] || die "未找到 node"
+
+STATS="$("$NODE_BIN" -e "
+const P='$PROJECT_DIR/node_modules/better-sqlite3';
+const D=require(P);
+const db=new D('$DATA_DIR/growth.db',{readonly:true});
+const q=(s)=>{try{return db.prepare(s).get().n}catch(e){return 0}};
+console.log(JSON.stringify({
+  goals:q(\"SELECT COUNT(*) n FROM goals WHERE deleted_at IS NULL\"),
+  activeGoals:q(\"SELECT COUNT(*) n FROM goals WHERE status='ACTIVE'\"),
+  actions:q('SELECT COUNT(*) n FROM actions'),
+  evidence:q('SELECT COUNT(*) n FROM evidence'),
+  events:q('SELECT COUNT(*) n FROM growth_events'),
+  confirmed:q('SELECT COUNT(*) n FROM goals WHERE status IN (\\'ACTIVE\\',\\'CONFIRMED\\',\\'COMPLETED\\')')
+}));
+" 2>/dev/null)"
+
+if [ -z "$STATS" ]; then
+  warn "无法读取统计（数据库可能损坏）"
+  STATS='{"goals":0,"activeGoals":0,"actions":0,"evidence":0,"events":0,"confirmed":0}'
+fi
+
+printf "  Goal: %s（其中活跃 %s）\n  Action: %s\n  Evidence: %s\n  Growth Event: %s\n\n" \
+  "$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).goals')" \
+  "$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).activeGoals')" \
+  "$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).actions')" \
+  "$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).evidence')" \
+  "$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).events')"
+
+if [ "${1:-}" = "--list" ]; then
+  exit 0
+fi
+
+CONFIRMED="$(echo "$STATS" | "$NODE_BIN" -p 'JSON.parse(require("fs").readFileSync(0,"utf8")).confirmed')"
+if [ "$CONFIRMED" -gt 0 ] && [ "$FORCE" -ne 1 ]; then
+  warn "检测到 $CONFIRMED 个已确认/活跃的 Goal —— 这看起来是真实使用数据，不是测试数据。"
+  warn "如需继续，请显式运行：./scripts/reset-dev-data.sh --force"
+  exit 1
+fi
+
+STAMP="$(date +%Y%m%d-%H%M%S)"
+BACKUP="$DATA_DIR.backup-$STAMP"
+printf "\033[1;33m▸ 将现有数据备份为：%s\033[0m\n" "$BACKUP"
+mv "$DATA_DIR" "$BACKUP" || die "备份失败，已中止（原数据未改动）"
+ok "备份完成（原数据完整保留在备份目录）"
+
+mkdir -p "$DATA_DIR"
+cd "$PROJECT_DIR"
+if [ -f dist/db/cli.js ]; then
+  AI_GROWTH_DATA_DIR="$DATA_DIR" "$NODE_BIN" dist/db/cli.js migrate >/dev/null && ok "已创建干净的数据库"
+else
+  warn "dist/db/cli.js 不存在，请先 npm run build，然后运行 npm run migrate"
+fi
+
+printf "\n完成。回滚方式：rm -rf \"%s\" && mv \"%s\" \"%s\"\n" "$DATA_DIR" "$BACKUP" "$DATA_DIR"