@leviyuan/lodestar 0.2.0 → 0.2.2

package/README.md

@@ -24,7 +24,6 @@ AI 不是帮手,是倍率。它放大的不是体力,是你——你的直觉、
 - ⌨️ **Type-ahead 不打断**:连珠炮全收,排队下一轮合并处理
 - 🔢 **合并消息加序号**:`[#N]\n` 前缀让模型看清独立边界
 - ⏳ **排队反应可见**:消息进队列加 ⏳,消化/取消自动清/换 ❌
-- 📨 **mid-turn 切新卡**:中途新消息 → 下一 tool 边界切新卡续写
 - ⏰ **定时唤醒可见化**:Cron / ScheduleWakeup 到点自开新卡
 - 📊 **footer 实时指标**:`✅ ⏱时长 · 📊上下文% · 💰本轮成本`
 - 📦 **`hi` 弹控制台**:跨群项目、上下文%、订阅额度一屏看完
@@ -65,7 +64,7 @@ AI 不是帮手,是倍率。它放大的不是体力,是你——你的直觉、
 
 **运行时**:[Bun](https://bun.sh) ≥ 1.0。
 
-**Claude Code**:装好且能跑 —— 详见[官方文档](https://docs.anthropic.com/en/docs/claude-code)。**强烈建议用 claude.ai 账号 OAuth 登录**(`claude auth login`),而不是 `ANTHROPIC_API_KEY`:Cron / ScheduleWakeup / `/schedule` 等定时唤醒工具只在 OAuth 模式下注册。
+**Claude Code**:装好且能跑 —— 详见[官方文档](https://docs.anthropic.com/en/docs/claude-code)。
 
 **飞书自建应用**:去[飞书开放平台](https://open.feishu.cn/app)→ 创建企业自建应用,然后:
 

package/package.json

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

package/src/cards.ts

@@ -668,7 +668,7 @@ export function consoleCard(opts: ConsoleOpts): object {
       lines.push(`　· ${dot} \`${p.name}\`${up}${mark}`)
     }
   }
-  if (contextTokens != null) {
+  if (contextTokens != null && contextTokens > 0) {
     const limit = contextLimit ?? 1_000_000
     const pct = limit > 0 ? Math.round((contextTokens / limit) * 100) : 0
     lines.push(`**📦 上下文**　${fmtTokens(contextTokens)} / ${fmtTokens(limit)}　(${pct}%)`)

package/src/instructions.ts

@@ -1,22 +1,13 @@
 /**
- * The system-prompt fragment Lodestar appends on every claude headless
- * launch. Carry-over of the original "channel instructions" from
- * Lodestar 1.x's MCP server, adapted for the streaming-card model where
- * Claude's own stdout already renders live in the Feishu group, so there
- * is no separate `reply` tool to call.
+ * Daemon ↔ model I/O contracts. Appended to claude's system prompt on
+ * every headless launch via `--append-system-prompt`. Three rules:
+ * inbound file marker, multi-content boundary marker, outbound file
+ * marker. Anything beyond pure I/O semantics (environment description,
+ * UX conventions, identity binding) was stripped 2026-05-16 — the
+ * model handles conversational flow natively, doesn't need to be told.
  */
 export const CHANNEL_INSTRUCTIONS = [
-  'You are running inside Lodestar, a daemon that bridges this session to a Feishu (Lark) group chat.',
-  'Your assistant text is streamed live as a Feishu card in that group; tool calls appear as collapsible panels; thinking is shown but de-emphasized. There is no separate reply tool — your normal conversational output IS the reply.',
-  '',
-  'Conventions for every turn:',
-  '- Open with one short acknowledgement so the user sees you started.',
-  '- Stream your conclusion before the turn ends; never end on a silent tool call. The card is your voice.',
-  '- For long work, drop progress sentences between tool calls so the user is not staring at a loading dot.',
-  '',
-  'Inbound user messages may carry a [file: /abs/path] hint when the user sent an image or attachment in Feishu. Read those files when relevant.',
-  '',
-  'To send a local file or image back to the user in this Feishu group, write the marker `[[send: /abs/path]]` (absolute path) anywhere in your reply, preferably on its own line at the end. The daemon strips every marker from the displayed card and posts the file as a separate Feishu message. Emit the marker only when the user asked for a file or when delivering a generated artifact (screenshot, diagram, exported doc) — not for arbitrary paths.',
-  '',
-  'The group name equals the working directory under $HOME and equals the Lodestar session name. Treat that binding as load-bearing — do not rename or move the directory.',
+  '- Text prefixed with `[file: /abs/path]` means a file is attached at that path; read it when relevant.',
+  '- A content block wrapped in `<u>...</u>` is an independent message — treat each `<u>` element in a multi-content turn as a separate input, even when their texts concatenate visually (e.g. `<u>1</u><u>45</u>` is two messages, not the number `145`).',
+  '- Write `[[send: /abs/path]]` anywhere in your reply (preferably on its own line) to deliver that file as a separate message. The marker is stripped from the displayed text. Emit only when the user asked for a file or you are delivering a generated artifact.',
 ].join('\n')

package/src/session.ts

@@ -137,25 +137,6 @@ export class Session {
    * to clear (via deleteReaction). Empty for eager-opened solo turns
    * and for scheduled wakeups (no user messages went into those). */
   private currentBatchReactionIds = new Map<string, string>()
-  /** Set the moment a mid-turn user message lands. Tells the next
-   * content-adding event (assistant text delta or fresh tool_use) to
-   * rotate the card before applying its update — closes the in-flight
-   * card with a `📨 转交新卡` footer and opens a fresh card, so the
-   * continuation has a visible boundary instead of piling up under
-   * one card. Reset to false after the rotation fires (or on
-   * stop/restart/exit). User feedback (2026-05-15): the prior
-   * everything-in-one-card behavior made the order feel jumbled. */
-  private wantsRotation = false
-  /** Holds assistant / thinking / tool_use events that arrive while a
-   * card rotation is mid-flight (close-old → open-new straddles a
-   * Feishu API await window during which `currentTurn` is transiently
-   * null). Replayed onto the new card the moment rotation completes
-   * so no streamed token is lost across the boundary. */
-  private rotationBuffer: Array<
-    | { kind: 'assistant'; delta: string }
-    | { kind: 'thinking'; delta: string }
-    | { kind: 'tool_use'; id: string; name: string; input: any }
-  > = []
   /** Count of `system/init` events seen this subprocess. The first one is
    * the boot init (claimed by whichever user message lands first); all
    * subsequent ones mark the start of an SDK-initiated turn (queued
@@ -311,8 +292,6 @@ export class Session {
     this.lastUserOpenId = ''
     this.pendingReactionIds = new Map()
     this.currentBatchReactionIds = new Map()
-    this.wantsRotation = false
-    this.rotationBuffer = []
     this.initCount = 0
     this.openingTurn = false
     this.pendingPermissions.clear()
@@ -333,8 +312,6 @@ export class Session {
     this.lastUserOpenId = ''
     this.pendingReactionIds = new Map()
     this.currentBatchReactionIds = new Map()
-    this.wantsRotation = false
-    this.rotationBuffer = []
     this.initCount = 0
     this.openingTurn = false
     this.pendingPermissions.clear()
@@ -416,7 +393,6 @@ export class Session {
         this.lastUserOpenId = ''
         this.pendingReactionIds = new Map()
         this.currentBatchReactionIds = new Map()
-        this.wantsRotation = false
         this.interrupt()
         return true
       case 'kill':
@@ -453,6 +429,7 @@ export class Session {
       // ~5s; not worth blocking the panel on it).
       usage: undefined,
       contextTokens: this.currentContextTokens(),
+      contextLimit: this.contextWindowMax(),
       cumStats: this.cumStats,
       lastTurn: this.lastTurnDelta
         ? {
@@ -511,14 +488,17 @@ export class Session {
     const wasBusy = this.currentTurn !== null || this.openingTurn
     this.pendingUserMessageCount++
     this.lastUserOpenId = userOpenId
-    // When this msg will be merged with siblings into a multi-content
-    // user turn (i.e. the SDK queued it because the daemon was busy),
-    // prepend a `[#N]\n` ordinal so the model can tell the merged
-    // blocks apart. Without it the harness renders multi-content text
-    // back-to-back ("1"+"2"+"5"+"56"+"89" → "1255689") and the model
-    // can't see the original boundaries — surfaced 2026-05-16 when a
-    // 5-msg accumulator test got mis-summed as one big number.
-    const wireText = wasBusy ? `[#${this.pendingUserMessageCount}]\n${text}` : text
+    // When the SDK will merge this msg with siblings into a multi-
+    // content user turn, wrap it in `<u>...</u>` so the model sees a
+    // structural boundary it actually attends to. Tried U+001E
+    // (ASCII Record Separator) first — invisible and theoretically
+    // perfect, but Anthropic's tokenizer effectively drops control
+    // chars and `<u>1</u><u>45</u>` became "145" to the model
+    // (2026-05-16 accumulator test). HTML-tag wrap is visible but
+    // models parse `<tag>` boundaries very reliably from training.
+    // Solo (eager-open) msgs don't get wrapped — no sibling, no
+    // merge, no need. Contract declared in CHANNEL_INSTRUCTIONS.
+    const wireText = wasBusy ? `<u>${text}</u>` : text
     this.proc!.sendUserText(wireText, files)
     if (wasBusy && msgId) {
       // Hold the slot in the map even if the API call hasn't returned
@@ -533,9 +513,6 @@ export class Session {
           this.pendingReactionIds.set(msgId, rid)
         }
       })()
-      // Rotation hint: a mid-turn user msg means the next assistant /
-      // tool event should split the visual into a new card.
-      this.wantsRotation = true
     }
     if (!this.currentTurn && !this.openingTurn && this.initCount >= 1) {
       // Eager open: this message is going to be processed solo (no current
@@ -850,7 +827,6 @@ export class Session {
       this.lastUserOpenId = ''
       this.pendingReactionIds = new Map()
       this.currentBatchReactionIds = new Map()
-      this.wantsRotation = false
       this.initCount = 0
       this.openingTurn = false
       this.status = 'stopped'
@@ -881,14 +857,17 @@ export class Session {
 
   /** Current context-window occupancy estimate — uses the most recent
    * assistant `usage` (input + caches), since each assistant reply replays
-   * the full conversation. Falls back to the last-turn delta when no
-   * assistant message has streamed yet this process. */
+   * the full conversation. Returns 0 when no per-call usage is available
+   * (process dead, or fresh spawn before first assistant message);
+   * `lastTurnDelta.inputTokens` is the CUMULATIVE turn input across all
+   * API calls in the turn (sum of cache_read across N steps) — using it
+   * here would inflate the percentage by Nx after a heavy multi-step
+   * turn (observed bug 2026-05-16: 417% in the `hi` panel after killing
+   * the proc with a long turn's delta still on file). */
   private currentContextTokens(): number {
     const u = this.proc?.lastUsage as ClaudeUsage | null | undefined
-    if (u) {
-      return (u.input_tokens ?? 0) + (u.cache_creation_input_tokens ?? 0) + (u.cache_read_input_tokens ?? 0)
-    }
-    return this.lastTurnDelta?.inputTokens ?? 0
+    if (!u) return 0
+    return (u.input_tokens ?? 0) + (u.cache_creation_input_tokens ?? 0) + (u.cache_read_input_tokens ?? 0)
   }
 
   /** Context-window capacity for the model the subprocess is currently
@@ -937,44 +916,8 @@ export class Session {
   // forget here and rely on enqueue source order — that way no `await`
   // can yield mid-handler and let `closeTurnCard` (or another event) race
   // and mutate `this.currentTurn` underfoot.
-  /** Rotate to a fresh card mid-turn: close the in-flight card with a
-   * `📨 转交新卡` footer (distinct from `✅ done` and `🛑 打断`) and
-   * open a new card so the post-user-message continuation has a
-   * visible boundary. Streams that land during the rotation's await
-   * windows are buffered in `rotationBuffer` and replayed onto the
-   * new card the moment it's ready, so no tokens are lost across the
-   * cut. Caller guarantees `wantsRotation` was true sync-immediately
-   * before. */
-  private async rotateCard(): Promise<void> {
-    this.openingTurn = true
-    try {
-      await this.closeTurnCard('📨 转交新卡')
-      await this.openTurnCard('', this.lastUserOpenId, 'user_message')
-    } finally {
-      this.openingTurn = false
-    }
-    if (this.rotationBuffer.length === 0) return
-    const buf = this.rotationBuffer
-    this.rotationBuffer = []
-    for (const e of buf) {
-      if (e.kind === 'assistant') this.appendAssistant(e.delta)
-      else if (e.kind === 'thinking') this.appendThinking(e.delta)
-      else if (e.kind === 'tool_use') this.addTool(e.id, e.name, e.input)
-    }
-  }
-
   private appendAssistant(delta: string): void {
-    if (!this.currentTurn) {
-      if (this.openingTurn) this.rotationBuffer.push({ kind: 'assistant', delta })
-      return
-    }
-    // Note: assistant text DOES NOT trigger rotation, even if a mid-turn
-    // user message landed and set `wantsRotation`. Rotating mid-segment
-    // would chop the model's in-progress reply (often a response to the
-    // ORIGINAL prompt that started this card) onto a fresh card,
-    // visually associating it with the queued msg — which is the bug
-    // the user surfaced 2026-05-16. The rotation defers to the next
-    // tool_use, which is a clean section boundary.
+    if (!this.currentTurn) return
     if (!this.currentTurn.currentAssistantSegmentId) {
       const i = this.currentTurn.assistantSegmentCount++
       const segId = cards.ELEMENTS.assistant(i)
@@ -1000,12 +943,7 @@ export class Session {
   }
 
   private appendThinking(delta: string): void {
-    if (!this.currentTurn) {
-      if (this.openingTurn) this.rotationBuffer.push({ kind: 'thinking', delta })
-      return
-    }
-    // Thinking, like assistant text, doesn't trigger rotation — it's
-    // preamble to the same response, not a section break.
+    if (!this.currentTurn) return
     this.currentTurn.thinkingText += delta
     cardkit.streamTextThrottled(
       this.currentTurn.cardId,
@@ -1023,16 +961,7 @@ export class Session {
   }
 
   private addTool(toolUseId: string, name: string, input: any): void {
-    if (!this.currentTurn) {
-      if (this.openingTurn) this.rotationBuffer.push({ kind: 'tool_use', id: toolUseId, name, input })
-      return
-    }
-    if (this.wantsRotation) {
-      this.wantsRotation = false
-      this.rotationBuffer.push({ kind: 'tool_use', id: toolUseId, name, input })
-      void this.rotateCard()
-      return
-    }
+    if (!this.currentTurn) return
     // Close current assistant segment (if any) so the tool panel renders
     // AFTER it in card body order. Flush queues the segment's last
     // buffered delta before the tool element is inserted.
@@ -1319,15 +1248,15 @@ export class Session {
     }
     const sendNote = sendPaths.length ? ` · 📎 ${sendPaths.length}` : ''
     // State marker leads the footer (✅ for natural completion, or the
-    // suffix verbatim for non-natural states like `📨 转交新卡`). The
+    // suffix verbatim for non-natural states like `🛑 打断`). The
     // trailing "done" word is gone — the ✅ already carries that
     // meaning. User-confirmed footer order 2026-05-16.
     const stateMark = suffix ? suffix : '✅'
     // Per-turn metrics: context-window occupancy (as a real percentage,
     // not a token count) and dollar cost. Only meaningful on a clean
-    // close — suffix-tagged turns (rotation / interrupt) didn't fire
-    // the `result` event that populates `lastTurnDelta`, so these
-    // numbers would be stale and misleading.
+    // close — suffix-tagged turns (interrupt) didn't fire the `result`
+    // event that populates `lastTurnDelta`, so these numbers would be
+    // stale and misleading.
     let metrics = ''
     if (!suffix) {
       const ctxTokens = this.currentContextTokens()