dsh-qqchat 0.2.3 → 0.2.5

package/lib/types.d.ts

@@ -54,6 +54,7 @@ export interface StoredAttachmentSummary {
 }
 export interface QQChatRuntimeSettings {
     memoryEnabled: boolean;
+    memoryMemberBatchEnabled: boolean;
     groupReceiveMode: GroupReceiveMode;
     groupReplyFormat: ReplyFormat;
     directReplyFormat: ReplyFormat;
@@ -65,6 +66,7 @@ export interface QQChatRuntimeSettings {
 }
 export interface QQChatRuntimeSettingsPatch {
     memoryEnabled?: boolean;
+    memoryMemberBatchEnabled?: boolean;
     groupReceiveMode?: GroupReceiveMode;
     groupReplyFormat?: ReplyFormat;
     directReplyFormat?: ReplyFormat;
@@ -384,6 +386,16 @@ export interface ModelRoute {
     model: string;
     sessionId?: string;
 }
+export type ReflectionScopeType = 'group' | 'member' | 'private';
+export type ReflectionTaskType = 'group' | 'member-batch' | 'private-owner';
+export interface ReflectionTaskInput {
+    scopeType: ReflectionScopeType;
+    scopeKey: number;
+    taskType: ReflectionTaskType;
+    startMessageId: number;
+    endMessageId: number;
+    idempotencyKey: string;
+}
 export interface PendingReply {
     text: string;
     onTextDelta?: (delta: string) => void;
@@ -402,6 +414,20 @@ export interface ReflectionMemberUpdate {
     memory?: unknown;
     nicknames?: unknown;
 }
+export interface ReflectionMemberBatchUpdate {
+    senderId?: unknown;
+    profile_add?: unknown;
+    profile_remove?: unknown;
+    pattern_add?: unknown;
+    pattern_remove?: unknown;
+    summary?: unknown;
+    daily?: unknown;
+    memory?: unknown;
+    nicknames?: unknown;
+}
+export interface MemberBatchReflectionPayload {
+    members?: ReflectionMemberBatchUpdate[];
+}
 export interface ReflectionPayload {
     group?: ReflectionGroupUpdate;
     members?: ReflectionMemberUpdate[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-qqchat",
-  "version": "0.2.3",
+  "version": "0.2.5",
   "description": "DeepSeek Harness 的 QQ 私聊/群聊插件，支持扫码授权、原生 Session、群记忆与工具权限。",
   "type": "module",
   "license": "MIT",
@@ -20,6 +20,7 @@
   "files": [
     "lib",
     "src",
+    "prompts",
     "client-src",
     "cordis.patch.yml",
     "README.md",

package/prompts/group-compression.md

@@ -0,0 +1,5 @@
+你负责维护 QQ 群长期记忆主档。把近期 daily 记录合并进已有 memory，合并重复、修正明确矛盾，但保留有价值的历史、日期、事件背景和变化过程；不要因为旧或细而删除历史，不评判、不推测，不能清空已有长期记忆。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字：
+
+{"memory":"更新后的长期记忆全文；不能清空"}

package/prompts/group-reflection.md

@@ -0,0 +1,39 @@
+你负责维护当前 QQ 群的公开长期记忆。你会收到当前群信息、已有群记忆和一批完整消息。这是群组反思，不是当前发言人的个人总结，也不是成员画像任务。
+
+## 一、群组记忆边界
+
+只记录当前群公开且明确的内容：
+
+- 群名称、用途和性质；
+- 群内明确确认的规则、协作约定和长期沟通偏好；
+- 明确公开的长期项目、共同决定、分工、关系和持续讨论；
+- 当前群正在进行的事项和近期状态。
+
+不要记录：
+
+- 单个成员的个人资料、兴趣、性格、经历或私聊内容；
+- 根据昵称、语气、@、引用或他人评价推断身份；
+- 一次性闲聊、玩笑、临时情绪和短期安排；
+- 没有明确依据的猜测；
+- 原始 senderId、groupId、openid 等内部 ID；
+- 群外信息。
+
+## 二、主体和证据判断
+
+先判断一条消息描述的是群体、某个成员、引用中的人，还是不明确的第三方，再判断是否属于群记忆。消息发送者不等于语义主体。引用和转述中的个人事实不能因为出现在群里就变成群事实；只有明确的群体决定、公开协作或群内共同事件才可以记录。
+
+“可能、应该、感觉、听说、好像、我觉得”不能作为确定事实。涉及时间时使用消息时间换算出的绝对日期，不使用“今天、明天、最近”等相对时间。
+
+## 三、字段规则
+
+- profile：稳定、公开、未来仍有参考价值的群事实；本批没有变化时保持原内容，不要清空或重写。
+- summary：不超过 150 字的当前群状态，回答“现在群里在做什么”；没有变化时沿用已有内容。
+- daily：本批值得留档的近期群事件、决定和讨论进展，一条一个事实；一次性内容不要写入 profile。
+- memory：真正长期有用的群项目、关系、约定和背景；不要复制完整聊天记录，也不要写个人属性。
+- 与 existing 冲突时，只有消息明确推翻旧内容才修正；不能因为新消息暂时没提到旧事实就删除。
+
+输出必须是严格 JSON，不要 Markdown、解释或额外文字。只修改 group，不要输出 members，也不要为 BOT 创建成员记忆。
+
+输出结构：
+
+{"group":{"profile":{},"summary":"","daily":"","memory":["..."]}}

package/prompts/member-batch-reflection.md

@@ -0,0 +1,39 @@
+你负责维护本批 QQ 群消息中多个成员的个人长期记忆。你会收到已有成员记忆、完整群消息和成员列表。这是成员批量反思，不是当前发言人的单人总结，也不是群组总结。
+
+## 一、先判断“是谁的”，再判断“是什么”
+
+对每条候选信息按以下顺序判断：
+
+1. 语义主体是发送者本人、其他群成员、群外的人、引用中的人，还是无法明确？
+2. 主体明确后，它是稳定个人资料、可复用行为模式、近期状态、高价值个人事件，还是只属于群组事件？
+
+只有主体能明确落到本批真实出现的 senderId，且内容描述该成员本人时，才允许写入该成员对象。消息发送者不等于语义主体，宁可漏记，也不要错记。
+
+## 二、允许输出的成员
+
+members 中只能包含 messages 里真实作为发送者出现、元数据提供 senderId、且确实有可记录个人信息的成员。不得因为某人被昵称提到、被 @、出现在引用中、被代词指代或被他人描述，就猜造其 senderId。没有可记内容的成员可以省略。senderId 是唯一身份依据，displayName 只用于理解和展示。
+
+## 三、主体归属规则
+
+- “我喜欢爵士”可以记为发送者本人的偏好。
+- “我觉得小明喜欢爵士”描述小明，不能记为发送者喜欢爵士。
+- “我和小明一起排查问题”可以记录发送者自己的协作模式，不能据此记录小明的能力或偏好。
+- 引用、转述、第三方评价和“他说/听说/好像/我觉得他”等模糊表达不能直接升级为个人记忆。
+- 只有被描述成员随后明确确认，才可以记录该成员自己的事实。
+- 群规、群角色、公共决定、群项目和群体关系属于 group，不写入成员记忆。
+- 不要为 BOT 创建成员记忆，也不要把 BOT 的消息当作任何成员的事实证据。
+
+## 四、字段和证据门槛
+
+- profile_add/profile_remove：稳定且未来有用的个人资料。type 只能是 name、address、pronoun、background、preference、note；涉及阶段性内容（最近、刚刚、目前、本周、暂时）不要放入 profile。
+- pattern_add/pattern_remove：重复且可复用、可观察的行为或决策模式。不能因为一次消息或一件事就推断稳定人格。
+- summary：不超过 120 字的近期状态，可以准确描述该成员参与的互动；没有变化时沿用 existing，不要写成流水账。
+- memory：高价值、可长期回看的个人事件，包含必要的时间、背景、行动和结果；其他人的属性和群组信息不能写入。
+- daily：本批重要但阶段性的个人事实，使用绝对日期；没有就返回空字符串。
+- 只返回本批新增或明确修正，不要回显已有内容。旧内容只有被明确推翻时才放入 remove 数组。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字。
+
+输出结构：
+
+{"members":[{"senderId":"本批消息中真实出现的可靠 ID","profile_add":[{"type":"name|address|pronoun|background|preference|note","text":"只描述该成员本人","ts":0}],"profile_remove":[{"text":"被明确推翻的旧资料"}],"pattern_add":[],"pattern_remove":[],"summary":"不超过120字","daily":"绝对日期的近期事实","memory":"高价值个人事件"}]}

package/prompts/member-compression.md

@@ -0,0 +1,5 @@
+你负责维护 QQ 成员长期记忆主档。把近期 daily 记录合并进已有 memory，结合 profile 和 pattern，保留有价值的历史、日期、项目背景和变化过程；不要重复抄写 profile/pattern，不评判、不推测，不能清空已有长期记忆，也不要把群组信息或其他人的属性写入当前成员记忆。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字：
+
+{"memory":"更新后的长期记忆全文；不能清空"}

package/prompts/private-reflection.md

@@ -0,0 +1,32 @@
+你负责维护当前 QQ 私聊对象的长期记忆。你会收到已有记忆和一批按时间排列的私聊消息，只针对这个 senderId，不针对 BOT，也不针对其他被提到的人。
+
+## 一、事实边界和主体判断
+
+输入中的 direction 是硬性事实边界：
+
+- direction=inbound 的消息是用户自己的表达，才可能产生用户事实；
+- direction=outbound 的 BOT 消息只是对话上下文，不能证明用户拥有某个偏好、身份、经历或状态；
+- 引用、转述、第三方描述、代词、玩笑、反问和“听说/好像/我觉得他”等内容，主体不明确时宁可不记；
+- senderId 是唯一身份依据，不能根据昵称、语气、最近发言或模型推断补全身份。
+
+## 二、记忆字段
+
+- profile：当前用户稳定的身份、背景、地址、称呼和长期偏好。阶段性内容（最近、刚刚、目前、本周、暂时）不要写入。
+- pattern：当前用户重复出现且可复用的行为或决策模式；一次行为不能直接推断稳定人格。
+- summary：不超过 120 字的近期状态或关注点；没有变化时原样沿用 existing，不要清空或改成流水账。
+- daily：本轮重要但阶段性的事实，一句话即可，涉及时间必须使用绝对日期。
+- memory：高价值、可长期回看的用户个人事件，保留必要时间、背景、行动和结果，不复制聊天原文。
+
+## 三、增量和安全规则
+
+- profile_add/profile_remove、pattern_add/pattern_remove 只包含本轮新增或明确修正，不要回显已有内容。
+- 只有被当前用户明确推翻的旧资料或模式才进入 remove 数组。
+- 不要把 BOT 的建议、观点或回复写成用户事实。
+- 不要把其他人的个人信息、群组规则或群体事件写入当前用户记忆。
+- 不确定时宁可漏记；existing 是已有事实，应克制更新而不是无条件推翻。
+
+严格只输出 JSON，不要 Markdown、解释或额外文字。
+
+输出结构：
+
+{"profile_add":[{"type":"name|address|pronoun|background|preference|note","text":"只描述当前私聊对象","ts":0}],"profile_remove":[{"text":"被明确推翻的旧资料"}],"pattern_add":[],"pattern_remove":[],"summary":"不超过120字的当前状态","daily":"绝对日期的阶段性事实","memory":"高价值个人事件"}

package/src/config.ts

@@ -10,10 +10,10 @@ const DEFAULT_CONFIG = Object.freeze({
   groupReadEnabled: true,
   replyFormat: 'smart' as ReplyFormat,
   recentGroupMessages: 40,
-  reflectionIdleMs: 120_000,
+  reflectionIdleMs: 900_000,
   reflectionBatchSize: 20,
   reflectionMaxMessages: 80,
-  memoryMaxTokens: 1400,
+  memoryMaxTokens: 4096,
   memoryCompressionMaxTokens: 15000,
 })
 
@@ -50,6 +50,7 @@ export function defaultRuntimeSettings(config: QQChatConfig): QQChatRuntimeSetti
     : config.groupRequiresAt ? 'mention' : 'auto'
   return {
     memoryEnabled: true,
+    memoryMemberBatchEnabled: true,
     groupReceiveMode,
     groupReplyFormat: 'compat',
     directReplyFormat: config.replyFormat,

package/src/index.ts

@@ -40,7 +40,9 @@ export function apply(ctx: Context, inputConfig: QQChatConfigInput = {}): void {
 
   ctx.connection.rpc.handle('/qqchat', createQQChatRpc(runtime), { authority: 'loopback' })
   ctx.effect(() => {
-    void runtime.start().catch(error => logger.error?.(error))
+    void (async () => {
+      await runtime.start()
+    })().catch(error => logger.error?.(error))
     return () => runtime.stop()
   }, 'dsh-qqchat runtime')
 }

package/src/session/agent-bridge.ts

@@ -39,7 +39,9 @@ interface AgentPreset { id: string }
 interface AgentPresetService { resolve(id?: string): Promise<AgentPreset>; list(): Promise<AgentPreset[]>; mount(ctx: Context, id: string): Promise<unknown>; recompose(ctx: Context, id: string): Promise<AgentPreset> }
 interface SessionPersistenceService { inspect(id: SessionId): Promise<{ meta: Session['header']; events: readonly SessionEvent[] }> }
 interface SessionTitleService { get(session: Session): unknown; rename(session: Session, title: string): unknown }
-interface WorkspaceRegistryService { archivedSessionIds: readonly string[] }
+interface WorkspaceRegistryService {
+  archivedSessionIds: readonly string[]
+}
 interface Composition { presetId?: string; setup?: AgentSetup }
 interface ActiveActor { chatType: ChatType; senderId: string }
 

package/src/session/memory-snapshot.ts

@@ -12,7 +12,7 @@ export interface MemorySnapshotEvent {
   type?: string
   time?: number
   data?: {
-    source?: { kind?: string; plugin?: string }
+    source?: { kind?: string; plugin?: string; sections?: readonly { name?: string; text?: string }[] }
     content?: readonly { type?: string; text?: string }[]
   }
 }
@@ -32,8 +32,11 @@ export function restoreMemorySnapshotState(events: readonly MemorySnapshotEvent[
   for (let index = events.length - 1; index >= 0; index -= 1) {
     const event = events[index]
     if (!event) continue
-    if (event.type !== 'user/message' || event.data?.source?.kind !== 'plugin' || event.data.source.plugin !== sourcePlugin) continue
-    const block = event.data.content?.length === 1 ? event.data.content[0] : undefined
+    const source = event.data?.source
+    if (event.type !== 'user/message' || source?.kind !== 'plugin' || source.plugin !== sourcePlugin) continue
+    if (!source.sections?.some(section => section.name === 'qq-chat-context')) continue
+    const content = event.data?.content
+    const block = content?.length === 1 ? content[0] : undefined
     if (block?.type !== 'text' || typeof block.text !== 'string') continue
     return { hash: memorySnapshotHash(block.text), lastInjectedAt: Number(event.time) || 0, stale: lastCompactionAt > (Number(event.time) || 0) }
   }

package/src/session/runtime.ts

@@ -58,6 +58,7 @@ export class QQChatRuntime {
 
   updateSettings(patch: QQChatRuntimeSettingsPatch): QQChatRuntimeSettings {
     if (patch.memoryEnabled !== undefined) this.db.setSetting('memoryEnabled', Boolean(patch.memoryEnabled))
+    if (patch.memoryMemberBatchEnabled !== undefined) this.db.setSetting('memoryMemberBatchEnabled', Boolean(patch.memoryMemberBatchEnabled))
     if (patch.groupReceiveMode !== undefined) {
       if (!isGroupReceiveMode(patch.groupReceiveMode)) throw new Error('无效的群聊接收模式')
       this.db.setSetting('groupReceiveMode', patch.groupReceiveMode)
@@ -120,7 +121,10 @@ export class QQChatRuntime {
       content: text, quotedText: '', mentioned: false, createdAt: Date.now(),
     }, row, true)
     if (this.settings().memoryEnabled) {
-      if (chatType === 'group') this.memory.schedule(Number(row.id))
+      if (chatType === 'group') {
+        this.memory.schedule(Number(row.id))
+        if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(row.id))
+      }
       else this.memory.scheduleMember(Number(row.id))
     }
     this.logger.info?.(`[dsh-qqchat] active ${chatType} message sent to ${shortId(targetId)}`)
@@ -241,8 +245,10 @@ export class QQChatRuntime {
       quotedText: message.quotedText, mentioned: message.mentioned, createdAt: Date.now(), attachments: publicAttachments(ownAttachments), quote: safeQuote,
     }
       if (settings.memoryEnabled) {
-        if (group) this.memory.schedule(Number(group.id))
-        else this.memory.scheduleMember(Number(member.id))
+        if (group) {
+          this.memory.schedule(Number(group.id))
+          if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(group.id))
+        }
       }
 
     if (!shouldReply) {
@@ -279,7 +285,10 @@ export class QQChatRuntime {
         memberId: message.chatType === 'c2c' ? member.id : undefined, direction: 'outbound', content: reply, mentioned: false,
       })
     if (settings.memoryEnabled) {
-      if (group) this.memory.schedule(Number(group.id))
+      if (group) {
+        this.memory.schedule(Number(group.id))
+        if (settings.memoryMemberBatchEnabled) this.memory.scheduleGroupMembers(Number(group.id))
+      }
       else this.memory.scheduleMember(Number(member.id))
     }
     } catch (error) {

package/src/storage/db.ts

@@ -27,9 +27,11 @@ import type {
   QQQuoteIndexRow,
   QQQuoteInput,
   StoredAttachmentSummary,
+  ReflectionTaskInput,
 } from '../types.js'
 
 const now = (): number => Date.now()
+const REFLECTION_TASK_STALE_MS = 15 * 60 * 1000
 
 function parseStringList(value: string | null | undefined): string[] {
   if (!value) return []
@@ -233,8 +235,23 @@ export class QQChatDatabase {
       CREATE TABLE IF NOT EXISTS reflection_state (
         group_id INTEGER PRIMARY KEY REFERENCES groups(id) ON DELETE CASCADE,
         last_message_id INTEGER NOT NULL DEFAULT 0,
+        last_member_reflected_message_id INTEGER NOT NULL DEFAULT 0,
         last_reflected_at INTEGER
       );
+      CREATE TABLE IF NOT EXISTS reflection_tasks (
+        id INTEGER PRIMARY KEY,
+        scope_type TEXT NOT NULL CHECK(scope_type IN ('group','member','private')),
+        scope_key INTEGER NOT NULL,
+        task_type TEXT NOT NULL CHECK(task_type IN ('group','member-batch','private-owner')),
+        start_message_id INTEGER NOT NULL,
+        end_message_id INTEGER NOT NULL,
+        status TEXT NOT NULL CHECK(status IN ('running','completed','failed')),
+        attempts INTEGER NOT NULL DEFAULT 0,
+        idempotency_key TEXT NOT NULL UNIQUE,
+        created_at INTEGER NOT NULL,
+        updated_at INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS reflection_tasks_scope ON reflection_tasks(scope_type, scope_key, task_type, status);
       CREATE TABLE IF NOT EXISTS outbox (
         id INTEGER PRIMARY KEY,
         account_id INTEGER NOT NULL REFERENCES accounts(id) ON DELETE CASCADE,
@@ -247,6 +264,8 @@ export class QQChatDatabase {
         error TEXT
       );
     `)
+    this.db.prepare("UPDATE reflection_tasks SET status='failed',updated_at=? WHERE status='running' AND updated_at<?")
+      .run(now(), now() - REFLECTION_TASK_STALE_MS)
     const columns = new Set(many<{ name: string }>(this.db.prepare('PRAGMA table_info(group_members)').all()).map(column => column.name))
     const groupColumns = new Set(many<{ name: string }>(this.db.prepare('PRAGMA table_info(groups)').all()).map(column => column.name))
     if (groupColumns.has('requires_at')) this.db.exec('ALTER TABLE groups DROP COLUMN requires_at')
@@ -254,6 +273,10 @@ export class QQChatDatabase {
     if (!columns.has('nicknames_json')) this.db.exec("ALTER TABLE group_members ADD COLUMN nicknames_json TEXT NOT NULL DEFAULT '[]'")
     if (!columns.has('message_count')) this.db.exec('ALTER TABLE group_members ADD COLUMN message_count INTEGER NOT NULL DEFAULT 0')
     const messageColumns = new Set(many<{ name: string }>(this.db.prepare('PRAGMA table_info(messages)').all()).map(column => column.name))
+    const reflectionColumns = new Set(many<{ name: string }>(this.db.prepare('PRAGMA table_info(reflection_state)').all()).map(column => column.name))
+    if (!reflectionColumns.has('last_member_reflected_message_id')) {
+      this.db.exec('ALTER TABLE reflection_state ADD COLUMN last_member_reflected_message_id INTEGER NOT NULL DEFAULT 0')
+    }
     if (!messageColumns.has('attachments_json')) this.db.exec('ALTER TABLE messages ADD COLUMN attachments_json TEXT')
     if (!messageColumns.has('quote_json')) this.db.exec('ALTER TABLE messages ADD COLUMN quote_json TEXT')
     this.db.exec(`UPDATE group_members SET message_count=(
@@ -375,6 +398,7 @@ export class QQChatDatabase {
   runtimeSettings(defaults: QQChatRuntimeSettings): QQChatRuntimeSettings {
     return {
       memoryEnabled: this.getSetting('memoryEnabled', defaults.memoryEnabled),
+      memoryMemberBatchEnabled: this.getSetting('memoryMemberBatchEnabled', defaults.memoryMemberBatchEnabled),
       groupReceiveMode: this.getSetting('groupReceiveMode', defaults.groupReceiveMode),
       groupReplyFormat: this.getSetting('groupReplyFormat', defaults.groupReplyFormat),
       directReplyFormat: this.getSetting('directReplyFormat', this.getSetting('replyFormat', defaults.directReplyFormat)),
@@ -690,12 +714,58 @@ export class QQChatDatabase {
     return Number(row?.n || 0)
   }
 
+  unreflectedMemberMessages(groupId: number, limit = 80): MessageRow[] {
+    const state = one<{ last_member_reflected_message_id: number }>(this.db.prepare(
+      'SELECT last_member_reflected_message_id FROM reflection_state WHERE group_id=?',
+    ).get(groupId))
+    const after = Number(state?.last_member_reflected_message_id || 0)
+    return many<MessageRow>(this.db.prepare(`SELECT m.*,mem.platform_user_id,mem.display_name
+      FROM messages m LEFT JOIN members mem ON mem.id=m.member_id
+      WHERE m.group_id=? AND m.id>? ORDER BY m.id ASC LIMIT ?`).all(groupId, after, limit))
+  }
+
+  unreflectedMemberCount(groupId: number): number {
+    const state = one<{ last_member_reflected_message_id: number }>(this.db.prepare(
+      'SELECT last_member_reflected_message_id FROM reflection_state WHERE group_id=?',
+    ).get(groupId))
+    const row = one<{ n: number }>(this.db.prepare(
+      'SELECT COUNT(*) AS n FROM messages WHERE group_id=? AND id>?',
+    ).get(groupId, Number(state?.last_member_reflected_message_id || 0)))
+    return Number(row?.n || 0)
+  }
+
   markReflected(groupId: number, messageId: number): void {
     this.db.prepare(`INSERT INTO reflection_state(group_id,last_message_id,last_reflected_at) VALUES(?,?,?)
       ON CONFLICT(group_id) DO UPDATE SET last_message_id=excluded.last_message_id,last_reflected_at=excluded.last_reflected_at`)
       .run(groupId, messageId, now())
   }
 
+  markMembersReflected(groupId: number, messageId: number): void {
+    this.db.prepare(`INSERT INTO reflection_state(group_id,last_message_id,last_member_reflected_message_id,last_reflected_at) VALUES(?,?,?,?)
+      ON CONFLICT(group_id) DO UPDATE SET last_member_reflected_message_id=excluded.last_member_reflected_message_id,last_reflected_at=excluded.last_reflected_at`)
+      .run(groupId, 0, messageId, now())
+  }
+
+  startReflectionTask(input: ReflectionTaskInput): boolean {
+    const existing = one<{ id: number; status: string }>(this.db.prepare(
+      'SELECT id,status FROM reflection_tasks WHERE idempotency_key=?',
+    ).get(input.idempotencyKey))
+    if (existing?.status === 'completed' || existing?.status === 'running') return false
+    if (existing) {
+      this.db.prepare(`UPDATE reflection_tasks SET status='running',attempts=attempts+1,updated_at=? WHERE id=?`)
+        .run(now(), existing.id)
+      return true
+    }
+    this.db.prepare(`INSERT INTO reflection_tasks(scope_type,scope_key,task_type,start_message_id,end_message_id,status,attempts,idempotency_key,created_at,updated_at)
+      VALUES(?,?,?,?,?,'running',1,?,?,?)`)
+      .run(input.scopeType, input.scopeKey, input.taskType, input.startMessageId, input.endMessageId, input.idempotencyKey, now(), now())
+    return true
+  }
+
+  finishReflectionTask(idempotencyKey: string, status: 'completed' | 'failed'): void {
+    this.db.prepare('UPDATE reflection_tasks SET status=?,updated_at=? WHERE idempotency_key=?').run(status, now(), idempotencyKey)
+  }
+
   memoryDocs(scopeType: MemoryScopeType, scopeKey: number): MemoryDocuments {
     const rows = many<{ doc_type: MemoryDocType; content: string; updated_at: number }>(
       this.db.prepare('SELECT doc_type,content,updated_at FROM memory_documents WHERE scope_type=? AND scope_key=?')