@leviyuan/lodestar 0.2.7 → 0.2.9

package/README.md

@@ -33,6 +33,7 @@ AI 不是帮手,是倍率。它放大的不是体力,是你——你的直觉、
 - 🗂 **多项目并发**:一个 daemon 持 N 群 ↔ N session
 - 🔄 **自动 resume**:重启自动续接,session_id 落盘不丢
 - 🛡 **systemd 守护级**:WS watchdog + 单 PID + alive marker
+- 📡 **HTTP 通知端点**:任意本机进程 `POST /notify` 一行 curl 把 markdown 推成卡片,info / warn / error 染色
 
 ## 怎么用
 
@@ -136,6 +137,53 @@ systemctl --user enable --now lodestar
 
 WS watchdog + alive-marker 的联手设计,意味着每次 systemd 拉起,daemon 会把**上次还在运行的 session 全部 `--resume` 自动复活**;你主动 `kill` 过的不会被吵醒。
 
+## 通知端点(Notify)
+
+本机任何进程都能往群里推一张卡片 —— 不走 SDK、不走鉴权,daemon 启动时
+顺带跑一个 loopback HTTP listener,默认绑 `127.0.0.1:9876`。
+
+```bash
+curl -fsS -X POST http://127.0.0.1:9876/notify \
+  -H 'content-type: application/json' \
+  -d '{"project":"feishu","text":"**build done** 12 files"}'
+```
+
+请求体:
+
+| 字段 | 必需 | 说明 |
+| --- | --- | --- |
+| `project` | ✅ | 飞书群名(= session 名 = `~/` 下的项目目录名)|
+| `text` | ✅ | Feishu schema-2.0 markdown:`**bold**`、`` `code` ``、`[link](url)`、`<font color='red'>…</font>`;~30 KB 上限,超限返回 502 |
+| `title` |   | 卡片 header 标题,默认等于 `project` |
+| `level` |   | `info`(默认,蓝)/ `warn`(黄)/ `error`(红)|
+
+响应:`200 {ok, chat_id, message_id}` / `400` 参数错 / `404` 群没绑定过 / `502` 飞书 API 拒收。
+
+> ⚠️ 群必须**至少有一条消息**触达过 daemon(WS 收到过),否则 `chatIdForSession` 查不到绑定,返回 404。新建群第一次发消息后即可用。
+
+可选配置(`~/.config/lodestar/config.toml`):
+
+```toml
+[notify]
+bind = "127.0.0.1"      # 默认 loopback;改 0.0.0.0 必须自己加前置鉴权
+port = 9876
+```
+
+cron / systemd hook 的常见用法:
+
+```cron
+0 3 * * * /usr/local/bin/backup.sh \
+  && curl -fsS -X POST http://127.0.0.1:9876/notify -H 'content-type: application/json' \
+       -d '{"project":"ops","text":"✅ nightly backup OK"}' \
+  || curl -fsS -X POST http://127.0.0.1:9876/notify -H 'content-type: application/json' \
+       -d '{"project":"ops","level":"error","text":"❌ nightly backup FAILED"}'
+```
+
+> 想让 Claude Code 自动调这个 endpoint(说一句"build 完通知我"就自己推),
+> 建议你自己写一个 skill —— 在 `~/.claude/skills/feishu-notify/SKILL.md`
+> 放一个 frontmatter + 触发关键词,把上面这段 curl 的 shape 抄进去即可。
+> 项目本身不附带 skill 文件,要不要装、装成什么样,完全交给你。
+
 ## 许可
 
 [MIT](LICENSE)

package/daemon.ts

@@ -15,6 +15,7 @@ import { chmodSync, existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSy
 import { dirname } from 'node:path'
 import { Session } from './src/session'
 import * as feishu from './src/feishu'
+import { startNotifyServer } from './src/notify'
 import { config } from './src/config'
 import { log } from './src/log'
 import { DEBUG_CTX_FILE, DEBUG_SOCK_FILE, PID_FILE } from './src/paths'
@@ -343,6 +344,7 @@ async function boot(): Promise<void> {
   log(`lodestar-daemon: WS started, watching ${feishu.chatNameCache.size} groups`)
 
   startDebugSocket()
+  startNotifyServer({ bind: config.notify.bind, port: config.notify.port })
 
   // Auto-revive sessions that were running when we last went down.
   // Runs AFTER the WS is up so any 🔁 revive message lands in the

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leviyuan/lodestar",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "publishConfig": {
     "access": "public"
   },

package/src/cardkit.ts

@@ -81,7 +81,12 @@ async function call(method: string, path: string, body?: object): Promise<any> {
 }
 
 function isStreamingClosed(e: unknown): boolean {
-  return typeof e === 'object' && e !== null && (e as any).code === 300309
+  if (typeof e !== 'object' || e === null) return false
+  const code = (e as any).code
+  // 300309 "streaming mode is closed" — TTL already fired before our write.
+  // 200850 "card streaming timeout"   — TTL fired exactly during our write.
+  // Both mean the streaming session is gone and a reopen will unstick the card.
+  return code === 300309 || code === 200850
 }
 
 /** Reopen streaming_mode on a card that Feishu auto-closed after its
@@ -98,11 +103,11 @@ async function reopenStreaming(cardId: string): Promise<void> {
 }
 
 /** Run `op` inside the per-card queue. If it fails with code=300309
- * (Feishu auto-closed streaming after the 10-minute TTL), reopen
- * streaming inline and retry `op` exactly once. Anything else — non-
- * 300309 failure, reopen failure, retry failure — is logged and
- * swallowed, matching the fire-and-forget contract every cardkit op
- * already has at the call sites. */
+ * or 200850 (Feishu auto-closed / timed-out streaming after the 10-
+ * minute TTL), reopen streaming inline and retry `op` exactly once.
+ * Anything else — other failure, reopen failure, retry failure — is
+ * logged and swallowed, matching the fire-and-forget contract every
+ * cardkit op already has at the call sites. */
 async function withReopenOnStreamingClosed(
   cardId: string,
   label: string,
@@ -118,7 +123,7 @@ async function withReopenOnStreamingClosed(
       if (onFailure) onFailure()
       return
     }
-    log(`cardkit ${label} ${cardId}: streaming closed (300309) — reopening`)
+    log(`cardkit ${label} ${cardId}: streaming closed (code=${(e as any).code}) — reopening`)
   }
   try {
     await reopenStreaming(cardId)

package/src/cards/console.ts

@@ -0,0 +1,352 @@
+/**
+ * Console / menu / settings cards — every non-turn-card Feishu surface
+ * the daemon paints. Companion file to turn.ts; both re-exported from
+ * src/cards.ts.
+ */
+
+import type { SysInfo } from '../sysinfo'
+import type { UsageSnapshot } from '../usage'
+import { ELEMENTS } from './elements'
+
+interface ConsoleOpts {
+  sessionName: string
+  status: 'idle' | 'working' | 'awaiting_permission' | 'starting' | 'stopped'
+  model?: string
+  effort?: string
+  /** ms since this ClaudeProcess spawned — formatted to "1h 23m" inside. */
+  uptimeMs?: number
+  /** All sessions currently running Claude across every Feishu group
+   * this daemon owns. Each entry is a sibling project. Empty/undefined
+   * → omit the section. The session matching this card's chat is
+   * flagged `isCurrent` so the row can be marked. */
+  peers?: Array<{
+    name: string
+    isCurrent: boolean
+    status: 'idle' | 'working' | 'awaiting_permission' | 'starting' | 'stopped'
+    uptimeMs?: number
+  }>
+  /** Subscription usage snapshot from ccusage. When `installed: false`
+   * the row renders an install hint; otherwise we surface the current
+   * 5h billing block + this week's aggregate. Undefined → omit row. */
+  usage?: UsageSnapshot
+  /** Current context-window occupancy estimate (input + cache tokens of
+   * the last assistant message). 0 if no turn has completed yet. */
+  contextTokens?: number
+  /** Window upper bound. `null` / undefined → unknown (e.g. spawn happened
+   * but no `result` has landed yet); renderer omits the `/ limit (pct%)`
+   * suffix instead of fabricating a default. */
+  contextLimit?: number | null
+  cumStats?: { tokens: number; costUsd: number; turns: number }
+  lastTurn?: { tokens: number; costUsd: number; durationMs: number }
+  sessionId?: string | null
+  /** Host snapshot: CPU 负载、内存、根/家目录磁盘、cc-* systemd 服务。
+   * undefined → 略过整个 host 段;数据自身字段缺失 (cpu/mem 为 null)
+   * 时单行渲染 `_n/a_`,不假数据。 */
+  sysinfo?: SysInfo
+}
+
+function fmtBytes(n: number): string {
+  if (n < 1024) return `${n}B`
+  if (n < 1024 * 1024) return `${(n / 1024).toFixed(0)}K`
+  if (n < 1024 * 1024 * 1024) return `${(n / (1024 * 1024)).toFixed(0)}M`
+  const gb = n / (1024 * 1024 * 1024)
+  return gb < 10 ? `${gb.toFixed(1)}G` : `${gb.toFixed(0)}G`
+}
+
+/** Format token counts as a compact human-readable string: 1,234 → 1.2K. */
+function fmtTokens(n: number): string {
+  if (!n) return '0'
+  if (n < 1000) return String(n)
+  if (n < 1_000_000) return (n / 1000).toFixed(n < 10_000 ? 1 : 0).replace(/\.0$/, '') + 'K'
+  return (n / 1_000_000).toFixed(2).replace(/\.?0+$/, '') + 'M'
+}
+
+function fmtCost(c: number): string {
+  if (c < 0.01) return `$${c.toFixed(4)}`
+  return `$${c.toFixed(2)}`
+}
+
+function fmtDurationMs(ms: number): string {
+  if (ms < 1000) return `${ms}ms`
+  if (ms < 60_000) return `${(ms / 1000).toFixed(1)}s`
+  const m = Math.floor(ms / 60_000)
+  const s = Math.round((ms % 60_000) / 1000)
+  return `${m}m ${s}s`
+}
+
+function fmtUptime(ms: number): string {
+  if (ms < 60_000) return `${Math.round(ms / 1000)}s`
+  const totalMin = Math.floor(ms / 60_000)
+  if (totalMin < 60) return `${totalMin}m`
+  const h = Math.floor(totalMin / 60)
+  const m = totalMin % 60
+  if (h < 24) return `${h}h ${m}m`
+  const d = Math.floor(h / 24)
+  return `${d}d ${h % 24}h`
+}
+
+/** Human-readable "time until" — null/past dates collapse to '已重置'. */
+function fmtResetIn(date: Date | null): string {
+  if (!date) return '?'
+  const ms = date.getTime() - Date.now()
+  if (ms <= 0) return '已重置'
+  if (ms < 60 * 60 * 1000) return `${Math.max(1, Math.round(ms / 60_000))}m`
+  if (ms < 24 * 60 * 60 * 1000) return `${Math.round(ms / (60 * 60 * 1000))}h`
+  return `${Math.round(ms / (24 * 60 * 60 * 1000))}d`
+}
+
+/** Human-readable "time since" — clamps sub-minute values to "刚刚". */
+function fmtAgo(timestamp: number): string {
+  const ms = Date.now() - timestamp
+  if (ms < 60_000) return '刚刚'
+  if (ms < 60 * 60 * 1000) return `${Math.round(ms / 60_000)}m 前`
+  if (ms < 24 * 60 * 60 * 1000) return `${Math.round(ms / (60 * 60 * 1000))}h 前`
+  return `${Math.round(ms / (24 * 60 * 60 * 1000))}d 前`
+}
+
+const PEER_STATUS_EMOJI: Record<string, string> = {
+  idle: '🟢', working: '⚙️', awaiting_permission: '🔐',
+  starting: '🚀', stopped: '⚪',
+}
+
+/** Render the subscription-usage section of the console card. Pulled out
+ * of `consoleCard` so the caller can patch it in after the initial card
+ * is on screen (网络往返可能慢于第一次 paint;先占位、回包后替换)。
+ *
+ * 数据源是 Anthropic 官方 OAuth Usage API (见 src/usage.ts)。
+ * 百分比是真实 utilization,失败态按 state 区分显示具体原因。
+ *
+ * `usage === undefined` → 初始 loading 占位。
+ */
+export function consoleUsageContent(
+  usage: UsageSnapshot | undefined,
+): string {
+  if (usage === undefined) return '**📊 订阅额度**　_加载中…_'
+  switch (usage.state) {
+    case 'no_credentials':
+      return '**📊 订阅额度**　未找到 OAuth 凭据 (`~/.claude/.credentials.json`)'
+    case 'auth_failed':
+      return '**📊 订阅额度**　Token 已过期且刷新失败 — 重新 `claude auth login`'
+    case 'rate_limited':
+      return '**📊 订阅额度**　API 429 限流,稍后重试'
+    case 'network':
+      return `**📊 订阅额度**　拉取失败${usage.reason ? ' — `' + usage.reason + '`' : ''}`
+  }
+  // state === 'ok' —— stale 时 head 加 "缓存 Xm 前",重置时间加 `~`
+  // 前缀,沿用 omchud HUD 的 stale 标记约定。
+  const staleNote = usage.stale ? ` _· 缓存 ${fmtAgo(usage.fetchedAt)}_` : ''
+  const resetPrefix = usage.stale ? '~' : ''
+  const head = usage.subscriptionType
+    ? `**📊 订阅额度** · ${usage.subscriptionType}${staleNote}`
+    : `**📊 订阅额度**${staleNote}`
+  const lines: string[] = [head]
+  if (usage.fiveHour) {
+    const parts = [`${Math.round(usage.fiveHour.percent)}%`]
+    if (usage.fiveHour.resetsAt) parts.push(`重置 ${resetPrefix}${fmtResetIn(usage.fiveHour.resetsAt)}`)
+    lines.push(`　· 5h　${parts.join(' · ')}`)
+  }
+  if (usage.weekly) {
+    const parts = [`${Math.round(usage.weekly.percent)}%`]
+    if (usage.weekly.resetsAt) parts.push(`重置 ${resetPrefix}${fmtResetIn(usage.weekly.resetsAt)}`)
+    lines.push(`　· 7d　${parts.join(' · ')}`)
+  }
+  return lines.length === 1 ? '**📊 订阅额度**　_无数据_' : lines.join('\n')
+}
+
+const SERVICE_STATUS_EMOJI: Record<string, string> = {
+  active: '🟢', activating: '🚀', reloading: '🔄',
+  inactive: '⚪', deactivating: '🟡', failed: '❌',
+}
+
+/** Host snapshot lines: 1 line for CPU+mem, 1 per disk, then services list.
+ * 跟 peers 同样的缩进风格 (`　· ` 开头),保持视觉一致。 */
+function hostLines(sysinfo: SysInfo): string[] {
+  const out: string[] = []
+  const head: string[] = []
+  if (sysinfo.cpu) {
+    const { cores, load1, load5, load15 } = sysinfo.cpu
+    head.push(`load ${load1.toFixed(2)} / ${load5.toFixed(2)} / ${load15.toFixed(2)} (${cores}核)`)
+  }
+  if (sysinfo.mem) {
+    head.push(`mem ${sysinfo.mem.percent}% (${fmtBytes(sysinfo.mem.usedBytes)}/${fmtBytes(sysinfo.mem.totalBytes)})`)
+  }
+  if (head.length > 0) out.push(`**🖥 主机**　${head.join(' · ')}`)
+  else out.push('**🖥 主机**　_n/a_')
+
+  if (sysinfo.disks.length > 0) {
+    const parts = sysinfo.disks.map(d =>
+      `\`${d.label}\` ${d.percent}% (${fmtBytes(d.usedBytes)}/${fmtBytes(d.totalBytes)})`,
+    )
+    out.push(`**💽 磁盘**　${parts.join(' · ')}`)
+  }
+
+  if (sysinfo.servicesError) {
+    out.push(`**⚙️ 服务** cc-*　_${sysinfo.servicesError}_`)
+  } else if (sysinfo.services.length === 0) {
+    out.push('**⚙️ 服务** cc-*　_无_')
+  } else {
+    out.push(`**⚙️ 服务** cc-* (${sysinfo.services.length})`)
+    for (const s of sysinfo.services) {
+      const dot = SERVICE_STATUS_EMOJI[s.active] ?? '·'
+      // 三件套: 状态 (active/inactive/failed) · 最近活跃 (上次进入
+      // active 距今多久) · 持续时间 (当前状态持续多久)。
+      // - active: 最近活跃 == 持续时间 (同一时刻),合并成"已运行 5m"
+      // - inactive/failed: 两者不同,分开显示"上次活跃 3d前 · 已停 1h"
+      // - activating/deactivating: 只显示当前状态持续时间
+      // - 从未跑过的 inactive: 只标"从未启动"
+      const lastActive = s.lastActiveAgoSec
+      const stateAge = s.stateAgoSec
+      const parts: string[] = [s.active]
+      if (s.active === 'active') {
+        if (stateAge != null) parts.push(`已运行 ${fmtUptime(stateAge * 1000)}`)
+      } else if (s.active === 'inactive' || s.active === 'failed') {
+        if (lastActive != null) {
+          parts.push(`上次活跃 ${fmtUptime(lastActive * 1000)}前`)
+        } else {
+          parts.push('从未启动')
+        }
+        if (stateAge != null) {
+          const verb = s.active === 'failed' ? '已挂' : '已停'
+          parts.push(`${verb} ${fmtUptime(stateAge * 1000)}`)
+        }
+      } else {
+        // activating / deactivating / reloading
+        if (stateAge != null) parts.push(`已 ${fmtUptime(stateAge * 1000)}`)
+      }
+      out.push(`　· ${dot} \`${s.name}\` · ${parts.join(' · ')}`)
+    }
+  }
+  return out
+}
+
+export function consoleCard(opts: ConsoleOpts): object {
+  const {
+    sessionName, status, model, effort, uptimeMs, peers, usage,
+    contextTokens, contextLimit, cumStats, lastTurn, sessionId, sysinfo,
+  } = opts
+  const statusEmoji = {
+    idle: '🟢 闲', working: '⚙️ 工作中', awaiting_permission: '🔐 等审批',
+    starting: '🚀 启动中', stopped: '⚪ 未运行',
+  }[status]
+
+  const modelLine = model ? `${model}${effort ? `/${effort}` : ''}` : null
+  const headerLine = [statusEmoji, modelLine].filter(Boolean).join(' · ')
+
+  // Build the metric lines that make this panel useful. Each is "label
+  // <tab> value" rendered as plain markdown — keeps it readable inside
+  // the small Feishu card area without competing with the button row.
+  const lines: string[] = [headerLine]
+
+  if (peers && peers.length > 0) {
+    lines.push(`**🗂 活跃项目** (${peers.length})`)
+    for (const p of peers) {
+      const dot = PEER_STATUS_EMOJI[p.status] ?? '·'
+      const up = p.uptimeMs != null && p.uptimeMs > 0 ? ` · ${fmtUptime(p.uptimeMs)}` : ''
+      const mark = p.isCurrent ? ' ← 当前' : ''
+      lines.push(`　· ${dot} \`${p.name}\`${up}${mark}`)
+    }
+  }
+  if (contextTokens != null && contextTokens > 0) {
+    // Show `/ limit (pct%)` only when we actually know the window —
+    // `contextLimit` is populated from the SDK's modelUsage on first
+    // `result`. Pre-result panels (fresh spawn / kill+hi / clear+hi)
+    // render token count alone rather than fabricating a 1M or 200K
+    // default that may not match the running model.
+    if (contextLimit != null && contextLimit > 0) {
+      const pct = Math.round((contextTokens / contextLimit) * 100)
+      lines.push(`**📦 上下文**　${fmtTokens(contextTokens)} / ${fmtTokens(contextLimit)}　(${pct}%)`)
+    } else {
+      lines.push(`**📦 上下文**　${fmtTokens(contextTokens)}　_窗口待 result 上报_`)
+    }
+  }
+  void uptimeMs // session-level uptime is already shown per-project in
+  // the 活跃项目 list above (peers[].uptimeMs); the dedicated row would
+  // duplicate it for the current session.
+  if (cumStats && (cumStats.tokens > 0 || cumStats.costUsd > 0 || cumStats.turns > 0)) {
+    lines.push(`**💬 累计**　${fmtTokens(cumStats.tokens)} tokens · ${fmtCost(cumStats.costUsd)} · ${cumStats.turns} turn${cumStats.turns === 1 ? '' : 's'}`)
+  }
+  if (lastTurn) {
+    lines.push(`**🔄 上一轮**　+${fmtTokens(lastTurn.tokens)} · ${fmtCost(lastTurn.costUsd)} · ${fmtDurationMs(lastTurn.durationMs)}`)
+  }
+  if (sessionId) {
+    lines.push(`**🆔 session**　\`${sessionId.slice(0, 8)}…\``)
+  }
+  if (sysinfo) {
+    lines.push(...hostLines(sysinfo))
+  }
+
+  const template = status === 'working' ? 'blue'
+    : status === 'awaiting_permission' ? 'orange'
+    : status === 'stopped' ? 'grey'
+    : 'green'
+
+  return {
+    schema: '2.0',
+    config: { update_multi: true },
+    header: {
+      title: { tag: 'plain_text', content: `🌟 Lodestar · ${sessionName}` },
+      template,
+    },
+    body: {
+      elements: [
+        { tag: 'markdown', content: lines.join('\n') },
+        // Separate element so showConsole() can replace it after the
+        // ccusage fetch completes — initial paint goes out immediately
+        // with `_加载中…_`, then this row swaps to real data.
+        {
+          tag: 'markdown',
+          element_id: ELEMENTS.consoleUsage,
+          content: consoleUsageContent(usage),
+        },
+      ],
+    },
+  }
+}
+
+interface MenuOpts {
+  question: string
+  options: string[]
+  requestId: string
+}
+
+export function menuCard(opts: MenuOpts): object {
+  const { question, options, requestId } = opts
+  return {
+    schema: '2.0',
+    config: { update_multi: true },
+    header: {
+      title: { tag: 'plain_text', content: '📋 等待选择' },
+      template: 'turquoise',
+    },
+    body: {
+      elements: [
+        { tag: 'markdown', content: question || '_请选择一项：_' },
+        ...options.map((opt, i) => ({
+          tag: 'button',
+          text: { tag: 'plain_text', content: opt },
+          type: 'default',
+          behaviors: [{ type: 'callback', value: { kind: 'menu', request_id: requestId, choice: i } }],
+        })),
+      ],
+    },
+  }
+}
+
+/** Settings patch applied when a turn finishes — flips streaming off
+ * and updates the chat-list preview with `⏱ duration · NK tokens`
+ * (or just the suffix if interrupted before a result event). */
+export function streamingOffSettings(opts: {
+  durationSec: string
+  tokens?: number
+  suffix?: string
+}): object {
+  const parts: string[] = []
+  parts.push(opts.suffix ?? '✅')
+  parts.push(`⏱ ${opts.durationSec}s`)
+  if (opts.tokens != null && opts.tokens > 0) {
+    parts.push(`${fmtTokens(opts.tokens)} tokens`)
+  }
+  return {
+    config: { streaming_mode: false, summary: { content: parts.join(' · ') } },
+  }
+}

package/src/cards/elements.ts

@@ -0,0 +1,22 @@
+/**
+ * Element-id convention (must be unique within a card):
+ *   user_input        — the collapsible "你说" panel
+ *   thinking          — the de-emphasized thinking stream
+ *   tool_<i>          — one collapsible per tool call, indexed from 0
+ *   assistant         — the main streaming assistant answer
+ *   footer            — runtime footer (timing / status)
+ */
+export const ELEMENTS = {
+  thinking: 'thinking',
+  footer: 'footer',
+  tool: (i: number) => `tool_${i}`,
+  /** Assistant text is segmented: every tool call closes the running segment
+   * and the next assistant chunk opens a new one, so element order in the
+   * card matches Claude's emission order. */
+  assistant: (i: number) => `assistant_${i}`,
+  /** Console (hi) card — the subscription-usage row is rendered as its
+   * own element so we can replace it after the initial card lands,
+   * decoupling the slow ccusage fetch from the rest of the panel's
+   * synchronous data. */
+  consoleUsage: 'console_usage',
+} as const