ai-growth 1.1.1 → 1.1.2

package/ROADMAP.md

@@ -0,0 +1,48 @@
+# 路线图与当前状态
+
+> 给「接手这个项目的下一个人 / 下一个 Agent」看：现在到哪了、下一步做什么、有哪些坑。
+> 更新于 2026-09-21。
+
+## 现状（已完成并有验证）
+
+| 项 | 状态 |
+|---|---|
+| Host app（CLI + MCP server + Web 面板 + 设备接入） | ✅ 可用；**197 个测试通过** |
+| npm 发布 | ✅ [`ai-growth@1.1.1`](https://www.npmjs.com/package/ai-growth)（`npm i -g ai-growth` 实测可用） |
+| AI Passport 玩法（设备端） | ✅ 已提交社区审核：projectId `566` / revisionId `1164` / **状态 `pending`（未公开）** |
+| 设备真机联调 | ✅ 已实测，含「电池供电开机纯白屏」根因修复 |
+| 文档结构 | ✅ README 给人看；`AGENTS.md` / `SKILL.md` / `llms.txt` 给 Agent；细节在 `docs/` |
+
+## 下一步（按优先级）
+
+1. **建公开仓库并推一次** — `package.json` / `server.json` / README 都已指向
+   `github.com/lairey-ai/ai-growth`，但仓库尚不存在 → npm 页面上的图片与文档链接现在是空的。
+2. **等玩法审核结果** → 通过后更新玩法，把使用方法的准备步骤补上
+   `npm install -g ai-growth`（提交时只写了 `ai-growth serve`，没说怎么装）。
+   ⚠️ 玩法当前有 pending 修订，**不得再提交新修订**，必须等结果。
+3. **Windows 支持** — `ai-growth device setup` 依赖系统的 `stty` 把串口设为 raw（Node 没有 termios），
+   Windows 上没有该命令：要么明确提示不支持，要么在 Node 里直接设置串口参数。
+4. **离线卡文案** — 设备离线卡只说"暂时连不上电脑"，应补一句
+   「在电脑上重跑 `ai-growth device setup`」；否则换过 Wi-Fi 的用户不知道该做什么。
+5. **收尾清理** — `~/.npmrc` 里存着 npm 发布令牌（可随时在 npm 后台撤销）。
+
+## 已知约束（都踩过，别再踩）
+
+- 🔴 **Node 版本分裂**：本机 shell 是 **Node 24**，而 `better-sqlite3` 按 **Node 22** 编译
+  → 用 Node 24 跑 `npm test` 或全局 `ai-growth` 会因 ABI 不匹配整片失败。
+  **根治**：`brew install node@22` → 把它的 `bin` 放到 PATH 中 `/usr/local/bin` 之前 →
+  `npm rebuild better-sqlite3`。**发布时必须 `npm publish --ignore-scripts`**（跳过 prepublishOnly）。
+- 🔴 **升版本要改两处**：`package.json` **和** `server.json`（后者版本必须与前者一致，有测试锁定）。
+- 🔴 **npm 令牌权限**：必须选 **All packages**；选 "Only select packages" 时**发不了一个还不存在的包**。
+- 🔴 **`ai-growth` 不在默认 PATH 上**：全局 bin 在 `~/.npm-global/bin`，只在用户的 zshrc 里加了 PATH。
+  非交互 shell（脚本、定时任务、Agent 会话）里必须显式用
+  `PATH="$HOME/.npm-global/bin:/Users/fuhaojie/.workbuddy/binaries/node/versions/22.22.2-3/bin:$PATH"`，
+  或直接调绝对路径 `"$HOME/.npm-global/bin/ai-growth"` —— 否则 `command not found`。
+- 🔴 **常驻服务不随代码更新自动重启**：更新后用
+  `launchctl kickstart -k "gui/$(id -u)/com.lairey.ai-growth.daemon"`。
+  排查"服务没在跑"的完整步骤见 `docs/usage.md`。
+- 🔴 **本机构建**：`npm run build` 里的 `rm -rf dist` 会被批量删除保护拦下 →
+  改用 `npx tsc -p tsconfig.json` + 手动 `cp` 资源（等价；`dist` 有逐字节一致性测试兜底）。
+- ⚠️ **时间处理**：`dateKey` 一律由服务端按配置时区算；客户端**不要**对 ISO 串 `slice(0,10)`（会差一天）。
+- ⚠️ **产品铁律不可违背**（见 README 与 `PRODUCT_SPEC.md`）：不编数值、不制造跨天债务、
+  首次使用必须先访谈。改动前先看 `AGENTS.md` 里的禁止事项。

package/dist/core/status.js

@@ -1,5 +1,5 @@
 import { getProfile, ensureProfile, getSetting } from './profile.js';
-import { getActiveGoals, getCurrentStage } from './goals.js';
+import { getActiveGoals, getCurrentStage, listGoals, listStages } from './goals.js';
 import { getTodayPlan } from './actions.js';
 import { hasPendingReplan } from './rollover.js';
 import { getActiveLifeContext } from './lifeContext.js';
@@ -14,9 +14,15 @@ export function growthStatus(ctx) {
         : profile.onboardingStatus === 'IN_PROGRESS'
             ? 'IN_PROGRESS'
             : 'COMPLETED';
-    const goals = getActiveGoals(ctx);
-    const primaryGoal = goals[0];
+    // ⚠️ 不能只看 ACTIVE 目标。目标处于 DRAFT（草稿待确认）或 CONFIRMED（已确认、尚未激活）时，
+    //   getActiveGoals() 也是空的 —— 于是这里会走到"没有目标 → 去聊目标"，
+    //   而用户明明已经访谈完、目标也确认过了。真机上就是这么把人卡住的：
+    //   status 说 DISCUSS_GOAL，但该做的是"排阶段计划"。
+    const openGoals = listGoals(ctx, ['DRAFT', 'CONFIRMED', 'ACTIVE']);
+    const goals = openGoals.filter((g) => g.status === 'ACTIVE');
+    const primaryGoal = goals[0] ?? openGoals.find((g) => g.status === 'CONFIRMED') ?? openGoals[0];
     const stage = primaryGoal ? getCurrentStage(ctx, primaryGoal.id) : null;
+    const hasStage = primaryGoal ? listStages(ctx, primaryGoal.id).length > 0 : false;
     const { plan, actions: todayActionsAll } = getTodayPlan(ctx);
     const life = getActiveLifeContext(ctx);
     const passportUpdated = getSetting(ctx, 'passport_last_generated_at') ?? undefined;
@@ -27,9 +33,21 @@ export function growthStatus(ctx) {
     else if (hasPendingReplan(ctx)) {
         suggested = 'RESOLVE_REPLAN';
     }
-    else if (goals.length === 0) {
+    else if (openGoals.length === 0) {
         suggested = 'DISCUSS_GOAL';
     }
+    else if (openGoals.some((g) => g.status === 'DRAFT')) {
+        // 草稿还在等用户确认 —— 这一步必须先做，否则后面做什么都不作数
+        suggested = 'CONFIRM_GOAL';
+    }
+    else if (!hasStage) {
+        // 有目标但没阶段计划：每日任务是**从当前阶段生成的**，没有阶段就排不出今天
+        suggested = 'CREATE_STAGE_PLAN';
+    }
+    else if (goals.length === 0) {
+        // 阶段排好了但目标还没激活（PAUSED 也落这里）
+        suggested = 'ACTIVATE_GOAL';
+    }
     else if (!plan) {
         suggested = 'RUN_DAILY_PLANNING';
     }

package/docs/usage.md

@@ -186,3 +186,32 @@ ai-growth device setup --ssid "你的Wi-Fi名" --pass "Wi-Fi密码"
 | 想确认状态机没被绕过 | `audit_log` 表记录了关键变动（含 Replan 决策）的 before/after 与原因 |
 | 面板打不开 / 白屏 | 面板由 daemon 提供：`bash scripts/doctor.sh` 看「面板 API」；单跑用 `npm run api`。白屏多半是 MIME 不对，重启进程即可 |
 | 打包后 API 调用失败 | WebView 必须加载 `http://localhost:4580`，不能用 `file://`（origin 为 null 会被 CORS 拦） |
+
+## 常驻服务（daemon）没在跑怎么办
+
+**症状**：面板打不开、设备显示"连不上电脑"的兜底卡，但你以为它一直在跑。
+
+先确认状态（三条命令逐级确认，别只看一条）：
+
+```bash
+launchctl print "gui/$(id -u)/com.lairey.ai-growth.daemon" | head    # 服务是否被 launchd 托管
+ls -l ~/Library/LaunchAgents/com.lairey.ai-growth.daemon.plist       # 服务定义是否还在
+# 最可靠的一条：直接看端口有没有人在听（不要用 curl，本机可能有代理会给出假的 502）
+node -e "const s=require('net').connect(4580,'127.0.0.1',()=>{console.log('在跑 ✓');s.end()}).on('error',()=>console.log('没在跑 ✗'))"
+```
+
+**最常见的原因**：你曾用 `ai-growth serve` 在前台跑过 —— 它把 daemon 当**子进程**拉起，
+**终端一关就把它带走了**（daemon 日志里会看到"启动了、但没有 SIGTERM 退出记录"）。
+
+**修复**（服务定义还在的话，一条命令即可）：
+
+```bash
+launchctl bootstrap "gui/$(id -u)" ~/Library/LaunchAgents/com.lairey.ai-growth.daemon.plist
+```
+
+服务定义丢了就重跑安装脚本，它会重建 plist、`bootout` → `bootstrap`，并且**验证进程真的活着**
+（`bootstrap` 返回成功不等于跑起来了 —— 这一点脚本里专门处理过）。
+
+> 常驻服务带 `KeepAlive` + `RunAtLoad`：登录自动启动，进程意外退出会自动拉起。
+> 它跑的是**全局安装的那一份**，所以更新代码后要用
+> `launchctl kickstart -k "gui/$(id -u)/com.lairey.ai-growth.daemon"` 让它换上新代码。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-growth",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "Agent-native、Local-first 的个人成长执行系统：AI 维护计划，人保留目标与最终确认权。",
   "mcpName": "io.github.lairey-ai/ai-growth",
   "type": "module",
@@ -38,6 +38,7 @@
     "AGENTS.md",
     "START-HERE.md",
     "README.md",
+    "ROADMAP.md",
     "LICENSE",
     "PRODUCT_SPEC.md",
     "IMPLEMENTATION_PLAN.md",

package/scripts/smoke-device.mjs

@@ -255,7 +255,7 @@ check('正确令牌（header）→ 200', (await q2('GET', '/api/device/ping', {
 check('正确令牌（query，固件走这条）→ 200', (await q2('GET', '/api/device/ping?token=smoke-token-1234')).status === 200);
 check('伪造 Host: 127.0.0.1 不能绕过 → 401', (await q2('GET', '/api/device/ping', { Host: '127.0.0.1' })).status === 401);
 check('面板接口仍锁回环（Host 127.0.0.1 → 200）', (await q2('GET', '/api/today', { Host: '127.0.0.1' })).status === 200);
-check('面板接口拒绝局域网 Host → 403', (await q2('GET', '/api/today', { Host: '192.168.3.46' })).status === 403);
+check('面板接口拒绝局域网 Host → 403', (await q2('GET', '/api/today', { Host: '192.168.1.10' })).status === 403);
 note(`当前令牌 = ${deviceToken(ctx)}`);
 
 // ═════════════════════ E) 跨天降级为迟记 ═════════════════════

package/server.json

@@ -3,7 +3,7 @@
   "name": "io.github.lairey-ai/ai-growth",
   "title": "AI Growth",
   "description": "Agent-native 的个人成长执行系统：访谈定目标、动态生成每日少量任务、跨天自动作废旧任务、用真实证据积累成长记录，并同步为可迁移的 AI Passport。",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "websiteUrl": "https://github.com/lairey-ai/ai-growth",
   "repository": {
     "url": "https://github.com/lairey-ai/ai-growth",
@@ -14,7 +14,7 @@
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "ai-growth",
-      "version": "1.1.1",
+      "version": "1.1.2",
       "transport": {
         "type": "stdio"
       },