@weavecode/weave 0.0.0-stage → 0.1.1

package/node_modules/@weavecode/server/dist/repositories/libraries.js

@@ -0,0 +1 @@
+import e from"node:path";import{getDataDir as n}from"../db/paths.js";import{isInsideDir as d,resolveLibraryPath as o,toRelPosix as h}from"../market/resolve.js";export class LibraryRepository{db;dataDir;constructor(t,r=n()){this.db=t,this.dataDir=r}add(t){const r=this.getByPath(t.path);return r||(this.db.prepare("INSERT OR IGNORE INTO libraries (path, kind, added_at) VALUES (?, ?, ?)").run(this.writeForm(t.path),t.kind,new Date().toISOString()),this.getByPath(t.path))}getByPath(t){for(const r of new Set([t,this.writeForm(t)])){const s=this.db.prepare("SELECT * FROM libraries WHERE path = ?").get(r);if(s)return this.resolveRow(a(s))}}getById(t){const r=this.db.prepare("SELECT * FROM libraries WHERE id = ?").get(t);return r?this.resolveRow(a(r)):void 0}list(){return this.db.prepare("SELECT * FROM libraries ORDER BY added_at DESC").all().map(t=>this.resolveRow(a(t)))}setPath(t,r){this.db.prepare("UPDATE libraries SET path = ? WHERE id = ?").run(this.writeForm(r),t)}remove(t){this.db.prepare("DELETE FROM libraries WHERE id = ?").run(t)}writeForm(t){return e.isAbsolute(t)&&d(t,this.dataDir)?h(t,this.dataDir):t}resolveRow(t){if(!e.isAbsolute(t.path))return{...t,path:o(t,this.dataDir)};const r=e.resolve(t.path);return d(r,this.dataDir)?(this.db.prepare("UPDATE libraries SET path = ? WHERE id = ?").run(h(r,this.dataDir),t.id),{...t,path:r}):t}}function a(i){return{id:Number(i.id),path:String(i.path),kind:i.kind,addedAt:String(i.added_at)}}

package/node_modules/@weavecode/server/dist/repositories/plugin-states.d.ts

@@ -0,0 +1,25 @@
+import type { DatabaseSync } from 'node:sqlite';
+export interface PluginStateRow {
+    id: string;
+    enabled: boolean;
+    /** 用户对 manifest `config` 的覆写（深度合并由加载器处理，这里只存原始覆写）。 */
+    config: Record<string, unknown>;
+    updatedAt: string;
+}
+/**
+ * 插件级开关与配置覆写（三通道统一状态源：内置/目录扫描/安装）。
+ * 本表 = user 档默认启停；project 档覆写在 projects.meta.plugins
+ * （plugin-project-state），SPI 插件单根安装无 local 档。
+ * 规则级 enabled 仍是 hook_rules 单一事实源；插件 disable 由管理面
+ * 级联把该插件全部规则 enabled 置 0（同事务），enable 恢复插件默认值。
+ */
+export declare class PluginStateRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    get(id: string): PluginStateRow | undefined;
+    list(): PluginStateRow[];
+    setEnabled(id: string, enabled: boolean): void;
+    setConfig(id: string, config: Record<string, unknown>): void;
+    remove(id: string): void;
+    private upsert;
+}

package/node_modules/@weavecode/server/dist/repositories/plugin-states.js

@@ -0,0 +1 @@
+export class PluginStateRepository{db;constructor(t){this.db=t}get(t){const e=this.db.prepare("SELECT * FROM plugin_states WHERE id = ?").get(t);if(e)return{id:String(e.id),enabled:Number(e.enabled)===1,config:JSON.parse(String(e.config??"{}")),updatedAt:String(e.updated_at)}}list(){return this.db.prepare("SELECT * FROM plugin_states ORDER BY id ASC").all().map(e=>({id:String(e.id),enabled:Number(e.enabled)===1,config:JSON.parse(String(e.config??"{}")),updatedAt:String(e.updated_at)}))}setEnabled(t,e){this.upsert(t,{enabled:e})}setConfig(t,e){this.upsert(t,{config:e})}remove(t){this.db.prepare("DELETE FROM plugin_states WHERE id = ?").run(t)}upsert(t,e){const n=this.get(t),i=new Date().toISOString(),s=e.enabled??n?.enabled??!0,r=e.config??n?.config??{};n?this.db.prepare("UPDATE plugin_states SET enabled = ?, config = ?, updated_at = ? WHERE id = ?").run(s?1:0,JSON.stringify(r),i,t):this.db.prepare("INSERT INTO plugin_states (id, enabled, config, updated_at) VALUES (?, ?, ?, ?)").run(t,s?1:0,JSON.stringify(r),i)}}

package/node_modules/@weavecode/server/dist/repositories/projects.d.ts

@@ -0,0 +1,68 @@
+import type { DatabaseSync } from 'node:sqlite';
+export interface ProjectRow {
+    id: number;
+    path: string;
+    name: string;
+    token: string;
+    source: 'init' | 'scan';
+    registeredAt: string;
+    lastSeenAt: string | null;
+    meta: string | null;
+    /** dashboard 手动拖出的位置（NULL = 未手动排序，列表里垫在已排序块之后）。 */
+    sortOrder: number | null;
+    /** 归档时间（NULL = 活跃）。归档项目不参与 server 任何消费面，仅保留基础信息待恢复。 */
+    archivedAt: string | null;
+}
+export interface RegisterProjectInput {
+    path: string;
+    name: string;
+    token: string;
+    source: 'init' | 'scan';
+}
+/**
+ * 项目注册键：绝对化 + 归一分隔符/尾斜杠，落**原生**形态。`D:/a/b` 与 `D:\a\b`
+ * 必须同键——否则 `ON CONFLICT(path)` 认不出、重复登记还会另发 token 把 hook 事件
+ * 拐到新行上。刻意保留原生分隔符：项目根要拿去和 payload / 请求里的 file_path 做
+ * 包含判断（asset 越界闸、crossProjectOnly），折成 posix 会让那些闸把合法路径判越界。
+ */
+export declare function projectKey(path: string): string;
+export declare class ProjectRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /**
+     * Register a project. Idempotent on `path`: re-registering refreshes
+     * `last_seen_at` but preserves the original token, name, and source.
+     * 归档态也一并保留——恢复只能走 dashboard 的归档面，`weave init` 不隐式解档。
+     */
+    register(input: RegisterProjectInput): ProjectRow;
+    getByPath(path: string): ProjectRow | undefined;
+    getByToken(token: string): ProjectRow | undefined;
+    getById(id: number): ProjectRow | undefined;
+    /**
+     * 活跃项目（归档排除）。这是所有消费面（watch/mirror/inbox 存活集/同步/
+     * 终端角标等）的统一口径——归档项目由 `listArchived()` 单独供「查看归档」面。
+     * 排序口径：手动序块在前（sort_order 升序），未手动排序的按注册时间倒序
+     * 垫尾——拖过的顺序权威，新注册项目照旧冒头在尾部可见位置。
+     */
+    list(): ProjectRow[];
+    /** 归档项目（仅基础信息，历史会话已在归档时清空），按归档时间倒序。 */
+    listArchived(): ProjectRow[];
+    /**
+     * dashboard 拖动排序的持久化：payload 即完整目标顺序（id 全量列表）。
+     * 幂等自愈——事务内先全清再按位写入，重复同一 payload 落同一状态；
+     * 未知 id（并发删除）静默跳过，缺席的 id 回到未排序块。
+     */
+    setOrder(ids: number[]): void;
+    touch(id: number): void;
+    remove(id: number): void;
+    /**
+     * 归档/恢复翻转。归档：置 archived_at、清 sort_order（退出活跃排序局，
+     * 恢复后垫在未排序块尾部）。恢复：置 NULL，归档期间各消费面按活跃口径自然回归。
+     * 行不存在返回 false。
+     */
+    setArchived(id: number, archived: boolean): boolean;
+    /** 读 meta JSON（缺失/损坏返回 null，调用方按需回退默认值）。 */
+    getMeta(id: number): Record<string, unknown> | null;
+    /** 浅合并写回 meta JSON（保留未触及的顶层键；批 10 toolkit 状态索引入口）。 */
+    setMeta(id: number, patch: Record<string, unknown>): void;
+}

package/node_modules/@weavecode/server/dist/repositories/projects.js

@@ -0,0 +1,3 @@
+import{resolve as o}from"node:path";export function projectKey(r){return o(r)}export class ProjectRepository{db;constructor(e){this.db=e}register(e){const t=new Date().toISOString(),s=projectKey(e.path);return this.db.prepare(`INSERT INTO projects (path, name, token, source, registered_at, last_seen_at)
+         VALUES (?, ?, ?, ?, ?, ?)
+         ON CONFLICT(path) DO UPDATE SET last_seen_at = excluded.last_seen_at`).run(s,e.name,e.token,e.source,t,t),this.getByPath(s)}getByPath(e){const t=this.db.prepare("SELECT * FROM projects WHERE path = ?").get(projectKey(e));return t?n(t):void 0}getByToken(e){const t=this.db.prepare("SELECT * FROM projects WHERE token = ?").get(e);return t?n(t):void 0}getById(e){const t=this.db.prepare("SELECT * FROM projects WHERE id = ?").get(e);return t?n(t):void 0}list(){return this.db.prepare("SELECT * FROM projects WHERE archived_at IS NULL ORDER BY sort_order IS NULL, sort_order ASC, registered_at DESC").all().map(e=>n(e))}listArchived(){return this.db.prepare("SELECT * FROM projects WHERE archived_at IS NOT NULL ORDER BY archived_at DESC").all().map(e=>n(e))}setOrder(e){this.db.exec("BEGIN");try{this.db.exec("UPDATE projects SET sort_order = NULL");const t=this.db.prepare("UPDATE projects SET sort_order = ? WHERE id = ?");e.forEach((s,a)=>{t.run(a,s)}),this.db.exec("COMMIT")}catch(t){throw this.db.exec("ROLLBACK"),t}}touch(e){this.db.prepare("UPDATE projects SET last_seen_at = ? WHERE id = ?").run(new Date().toISOString(),e)}remove(e){this.db.prepare("DELETE FROM projects WHERE id = ?").run(e)}setArchived(e,t){return(t?this.db.prepare("UPDATE projects SET archived_at = ?, sort_order = NULL WHERE id = ?").run(new Date().toISOString(),e):this.db.prepare("UPDATE projects SET archived_at = NULL WHERE id = ?").run(e)).changes>0}getMeta(e){const t=this.db.prepare("SELECT meta FROM projects WHERE id = ?").get(e);if(!t||t.meta==null)return null;try{const s=JSON.parse(String(t.meta));return s&&typeof s=="object"&&!Array.isArray(s)?s:null}catch{return null}}setMeta(e,t){const s={...this.getMeta(e)??{},...t};this.db.prepare("UPDATE projects SET meta = ? WHERE id = ?").run(JSON.stringify(s),e)}}function n(r){return{id:Number(r.id),path:String(r.path),name:String(r.name),token:String(r.token),source:r.source,registeredAt:String(r.registered_at),lastSeenAt:r.last_seen_at==null?null:String(r.last_seen_at),meta:r.meta==null?null:String(r.meta),sortOrder:r.sort_order==null?null:Number(r.sort_order),archivedAt:r.archived_at==null?null:String(r.archived_at)}}

package/node_modules/@weavecode/server/dist/repositories/push-subscriptions.d.ts

@@ -0,0 +1,27 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * Web Push 订阅（每浏览器安装一份）：endpoint = 推送服务分配的绝对 URL（天然
+ * 唯一键）；p256dh/auth = 浏览器生成的加密密钥对（aes128gcm 载荷加密用）。
+ * 生命周期由推送服务裁决——发送侧收到 404/410 即删行，没有手工管理面。
+ */
+export interface PushSubscriptionRow {
+    endpoint: string;
+    p256dh: string;
+    auth: string;
+    userAgent: string | null;
+    createdAt: string;
+}
+export declare class PushSubscriptionRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /** 同 endpoint 重订阅 = 覆写密钥（浏览器 rotate 密钥后 endpoint 常不变）。 */
+    upsert(input: {
+        endpoint: string;
+        p256dh: string;
+        auth: string;
+        userAgent?: string | null;
+    }): PushSubscriptionRow;
+    getById(endpoint: string): PushSubscriptionRow | undefined;
+    list(): PushSubscriptionRow[];
+    deleteByEndpoint(endpoint: string): boolean;
+}

package/node_modules/@weavecode/server/dist/repositories/push-subscriptions.js

@@ -0,0 +1,4 @@
+export class PushSubscriptionRepository{db;constructor(e){this.db=e}upsert(e){return this.db.prepare(`INSERT INTO push_subscriptions (endpoint, p256dh, auth, user_agent, created_at)
+         VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(endpoint) DO UPDATE SET p256dh = excluded.p256dh, auth = excluded.auth,
+           user_agent = excluded.user_agent`).run(e.endpoint,e.p256dh,e.auth,e.userAgent??null,new Date().toISOString()),this.getById(e.endpoint)}getById(e){const n=this.db.prepare("SELECT * FROM push_subscriptions WHERE endpoint = ?").get(e);return n?r(n):void 0}list(){return this.db.prepare("SELECT * FROM push_subscriptions ORDER BY created_at, endpoint").all().map(r)}deleteByEndpoint(e){return Number(this.db.prepare("DELETE FROM push_subscriptions WHERE endpoint = ?").run(e).changes)===1}}function r(t){return{endpoint:String(t.endpoint),p256dh:String(t.p256dh),auth:String(t.auth),userAgent:t.user_agent==null?null:String(t.user_agent),createdAt:String(t.created_at)}}

package/node_modules/@weavecode/server/dist/repositories/session-messages.d.ts

@@ -0,0 +1,50 @@
+import type { DatabaseSync } from 'node:sqlite';
+/** 投递模式：inject = 非抢占注入（忙排）；headless = 强制回合（闲投）；auto = 按忙闲裁决。 */
+export type MessageMode = 'inject' | 'headless' | 'auto';
+/** inject 置 injected（outbox 已写入，随下一拍送达）；headless 走 running → 终态。 */
+export type MessageStatus = 'queued' | 'injected' | 'running' | 'succeeded' | 'failed' | 'timeout';
+/** 发起方：dashboard（web）/ session（会话间）/ cli（终端命令）。 */
+export type MessageFromKind = 'dashboard' | 'session';
+export interface SessionMessageInput {
+    fromKind: MessageFromKind;
+    fromSessionId?: string | null;
+    toSessionId: string;
+    text: string;
+    mode: MessageMode;
+    status: MessageStatus;
+}
+export interface SessionMessageRow {
+    id: number;
+    fromKind: MessageFromKind;
+    fromSessionId: string | null;
+    toSessionId: string;
+    text: string;
+    mode: MessageMode;
+    status: MessageStatus;
+    output: string | null;
+    error: string | null;
+    createdAt: string;
+    deliveredAt: string | null;
+    finishedAt: string | null;
+}
+export interface UpdateMessageStatusInput {
+    status: MessageStatus;
+    output?: string | null;
+    error?: string | null;
+    delivered?: boolean;
+    finished?: boolean;
+}
+/** session_messages 点对点消息域（append + 状态流转），与指令池分表分域。 */
+export declare class SessionMessageRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    insert(input: SessionMessageInput): SessionMessageRow;
+    getById(id: number): SessionMessageRow | undefined;
+    updateStatus(id: number, input: UpdateMessageStatusInput): SessionMessageRow | undefined;
+    /** 会话线程（双向：收到的 + 发出的），升序、限最新 limit 条。 */
+    listBySession(sessionId: string, limit?: number): SessionMessageRow[];
+    /** 删会话连带清消息（双向都指向已消失会话的孤行不留）。 */
+    deleteBySession(sessionId: string): number;
+    /** 归档项目清空其会话的消息（收/发两端任一落在该项目即算）。 */
+    deleteByProject(projectId: number): number;
+}

package/node_modules/@weavecode/server/dist/repositories/session-messages.js

@@ -0,0 +1,11 @@
+export class SessionMessageRepository{db;constructor(s){this.db=s}insert(s){const t=this.db.prepare(`INSERT INTO session_messages
+           (from_kind, from_session_id, to_session_id, text, mode, status, created_at)
+         VALUES (?, ?, ?, ?, ?, ?, ?)`).run(s.fromKind,s.fromSessionId??null,s.toSessionId,s.text,s.mode,s.status,new Date().toISOString());return this.getById(Number(t.lastInsertRowid))}getById(s){const t=this.db.prepare("SELECT * FROM session_messages WHERE id = ?").get(s);return t?r(t):void 0}updateStatus(s,t){const i=new Date().toISOString();return this.db.prepare(`UPDATE session_messages
+         SET status = ?, output = COALESCE(?, output), error = COALESCE(?, error),
+             delivered_at = CASE WHEN ? = 1 THEN ? ELSE delivered_at END,
+             finished_at = CASE WHEN ? = 1 THEN ? ELSE finished_at END
+         WHERE id = ?`).run(t.status,t.output??null,t.error??null,t.delivered?1:0,i,t.finished?1:0,i,s),this.getById(s)}listBySession(s,t=100){const i=Math.min(Math.max(t,1),300);return this.db.prepare(`SELECT * FROM session_messages
+         WHERE to_session_id = ? OR from_session_id = ?
+         ORDER BY id DESC LIMIT ?`).all(s,s,i).map(r).reverse()}deleteBySession(s){return Number(this.db.prepare("DELETE FROM session_messages WHERE to_session_id = ? OR from_session_id = ?").run(s,s).changes)}deleteByProject(s){return Number(this.db.prepare(`DELETE FROM session_messages
+           WHERE to_session_id IN (SELECT session_id FROM sessions WHERE project_id = ?)
+              OR from_session_id IN (SELECT session_id FROM sessions WHERE project_id = ?)`).run(s,s).changes)}}function r(e){return{id:Number(e.id),fromKind:String(e.from_kind),fromSessionId:e.from_session_id==null?null:String(e.from_session_id),toSessionId:String(e.to_session_id),text:String(e.text),mode:String(e.mode),status:String(e.status),output:e.output==null?null:String(e.output),error:e.error==null?null:String(e.error),createdAt:String(e.created_at),deliveredAt:e.delivered_at==null?null:String(e.delivered_at),finishedAt:e.finished_at==null?null:String(e.finished_at)}}

package/node_modules/@weavecode/server/dist/repositories/session-sequences.d.ts

@@ -0,0 +1,49 @@
+import type { DatabaseSync } from 'node:sqlite';
+import type { MessageMode } from '../hooks/message-deliverer.js';
+/** 序列步（steps JSON 的一格）。messageId 为步触发后回填的管道发号（内存关联，非 DB 行）。 */
+export interface SequenceStep {
+    to: string;
+    text: string;
+    mode: MessageMode;
+    /** null = 本步尚未触发（或触发前落库）；重启恢复时区分等待通道用。 */
+    messageId?: string;
+}
+export type SequenceStatus = 'running' | 'done' | 'failed' | 'cancelled';
+export interface SessionSequenceRow {
+    id: number;
+    name: string;
+    steps: SequenceStep[];
+    status: SequenceStatus;
+    /** 正在等待完成的步下标；全落 = steps.length。 */
+    cursor: number;
+    error: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** session_sequences 跨会话序列域（session-orchestration 批 3）：状态全在行，引擎无内存权威态。 */
+export declare class SessionSequenceRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    insert(input: {
+        name: string;
+        steps: SequenceStep[];
+    }): SessionSequenceRow;
+    getById(id: number): SessionSequenceRow | undefined;
+    /** 最近的序列（画布历史 + 列表），新在前。 */
+    list(limit?: number): SessionSequenceRow[];
+    /** 引擎扫描面：全部进行中的序列。 */
+    listRunning(): SessionSequenceRow[];
+    /**
+     * CAS 推进：cursor from→to 且仍 running。false = 已被并发推进或落定，
+     * 调用方必须放弃后续副作用（防同批多事件重复触发下一拍）。
+     */
+    advanceCursor(id: number, from: number, to: number): boolean;
+    /** 终态落定（CAS running → status）；false = 已有并发终态。 */
+    finish(id: number, status: 'done' | 'failed' | 'cancelled', error?: string | null): boolean;
+    /** 步触发后回填 messageId（管道发号；步数组读改写后整体落库，单线程无竞态）。 */
+    setStepMessage(id: number, stepIndex: number, messageId: string): void;
+    /** 删会话/归档连带清：任一步目标落在给定会话集内的行不留。 */
+    deleteMentioning(sessionIds: ReadonlySet<string>): number;
+    /** 归档项目连带清（须在项目会话行删除前调用——靠 sessions 表圈目标集）。 */
+    deleteByProject(projectId: number): number;
+}

package/node_modules/@weavecode/server/dist/repositories/session-sequences.js

@@ -0,0 +1,4 @@
+export class SessionSequenceRepository{db;constructor(e){this.db=e}insert(e){const s=new Date().toISOString(),t=this.db.prepare(`INSERT INTO session_sequences (name, steps, status, cursor, created_at, updated_at)
+         VALUES (?, ?, 'running', 0, ?, ?)`).run(e.name,JSON.stringify(e.steps),s,s);return this.getById(Number(t.lastInsertRowid))}getById(e){const s=this.db.prepare("SELECT * FROM session_sequences WHERE id = ?").get(e);return s?u(s):void 0}list(e=50){return this.db.prepare("SELECT * FROM session_sequences ORDER BY id DESC LIMIT ?").all(e).map(u)}listRunning(){return this.db.prepare("SELECT * FROM session_sequences WHERE status = 'running' ORDER BY id").all().map(u)}advanceCursor(e,s,t){return Number(this.db.prepare(`UPDATE session_sequences SET cursor = ?, updated_at = ?
+             WHERE id = ? AND status = 'running' AND cursor = ?`).run(t,new Date().toISOString(),e,s).changes)===1}finish(e,s,t=null){return Number(this.db.prepare(`UPDATE session_sequences SET status = ?, error = ?, updated_at = ?
+             WHERE id = ? AND status = 'running'`).run(s,t,new Date().toISOString(),e).changes)===1}setStepMessage(e,s,t){const n=this.getById(e);!n||n.steps[s]==null||(n.steps[s].messageId=t,this.db.prepare("UPDATE session_sequences SET steps = ?, updated_at = ? WHERE id = ?").run(JSON.stringify(n.steps),new Date().toISOString(),e))}deleteMentioning(e){if(e.size===0)return 0;const s=this.list(1e3).filter(n=>n.steps.some(i=>e.has(i.to)));if(s.length===0)return 0;const t=this.db.prepare("DELETE FROM session_sequences WHERE id = ?");return s.reduce((n,i)=>n+Number(t.run(i.id).changes),0)}deleteByProject(e){const s=new Set(this.db.prepare("SELECT session_id FROM sessions WHERE project_id = ?").all(e).map(t=>String(t.session_id)));return this.deleteMentioning(s)}}function u(r){let e=[];try{e=JSON.parse(String(r.steps))}catch{e=[]}return{id:Number(r.id),name:String(r.name),steps:Array.isArray(e)?e:[],status:String(r.status),cursor:Number(r.cursor),error:r.error==null?null:String(r.error),createdAt:String(r.created_at),updatedAt:String(r.updated_at)}}

package/node_modules/@weavecode/server/dist/repositories/session-watches.d.ts

@@ -0,0 +1,64 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * 会话订阅的触发类型（命中其一即 fire）：
+ *   idle          = 目标空闲（harness 的 idleSignals 全集，批 2 语义）
+ *   turnEnd       = 一轮对话结束（HARNESS_LIFECYCLE[<harness>].close，claude = Stop）
+ *   messageFailed = 该会话有消息投递失败/超时（管道 message.finished 帧）
+ * 一条订阅可含多种（订阅时选）；老行/未指定 = 缺省 idle。
+ */
+export type WatchOn = 'idle' | 'turnEnd' | 'messageFailed';
+export declare const WATCH_ON_VALUES: readonly WatchOn[];
+export declare const DEFAULT_WATCH_ON: readonly WatchOn[];
+export interface SessionWatchRow {
+    id: number;
+    /** null = dashboard 订阅（fire 走 SSE/toast）；会话 id = 通知注入该会话。 */
+    watcherSessionId: string | null;
+    targetSessionId: string;
+    /** 触发类型集（至少一项）。 */
+    onEvents: WatchOn[];
+    /** 剩余提醒次数（**所有已选类型共用**）；null = 持久化（不自动失效）。 */
+    remaining: number | null;
+    /** 注入 watcher 会话的文本；null = fire 时按目标会话渲染缺省文案。 */
+    notify: string | null;
+    /** 落定时刻（次数耗尽或 one-shot 命中）；null = 仍然有效。 */
+    firedAt: string | null;
+    createdAt: string;
+}
+/** session_watches 会话订阅域（session-orchestration 批 2 + 提醒类型）：one-shot，fire 即失效。 */
+export declare class SessionWatchRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    insert(input: {
+        watcherSessionId: string | null;
+        targetSessionId: string;
+        notify: string | null;
+        onEvents?: readonly WatchOn[];
+        /** 提醒次数；null/缺省 = 1（一次，批 2 语义）；显式 null 传「持久化」用 remaining。 */
+        times?: number | null;
+    }): SessionWatchRow;
+    getById(id: number): SessionWatchRow | undefined;
+    /** 目标会话的待触发订阅（onIngest 命中 idleSignals 后逐条 fire）。 */
+    listPendingByTarget(targetSessionId: string): SessionWatchRow[];
+    /** 全部待触发订阅（terminated 补射扫描面）。 */
+    listPending(): SessionWatchRow[];
+    /**
+     * 命中一次（**单条原子 UPDATE**，跨连接也安全——inbox 消费线程持有第二个连接）：
+     * 计数订阅 `remaining = remaining - 1`，减到 0 当即落定；持久化订阅（remaining
+     * IS NULL）不消耗，只校验仍然有效。返回 null = 已失效（并发方吃掉最后一次 /
+     * 次数耗尽）——调用方必须放弃副作用（防同批 Stop/SessionEnd 双事件双投递）。
+     */
+    consumeHit(id: number): SessionWatchRow | null;
+    /** 改写待触发订阅的类型集/剩余次数（dashboard 订阅修改即 upsert 的落点）；
+     *  已落定（fired）行不可改，返回 undefined。 */
+    updateById(id: number, patch: {
+        onEvents?: WatchOn[];
+        remaining: number | null;
+    }): SessionWatchRow | undefined;
+    deleteById(id: number): boolean;
+    /** 删会话连带清：目标或订阅方任一指向已消失会话的行不留。 */
+    deleteBySession(sessionId: string): number;
+    /** 归档项目清空其会话的订阅（两端任一落在该项目即算）。 */
+    deleteByProject(projectId: number): number;
+}
+/** 触发类型集解析：坏值/空/老行（列未写）= 缺省 idle。 */
+export declare function parseOn(raw: unknown): WatchOn[];

package/node_modules/@weavecode/server/dist/repositories/session-watches.js

@@ -0,0 +1,5 @@
+export const WATCH_ON_VALUES=["idle","turnEnd","messageFailed"],DEFAULT_WATCH_ON=["idle"];export class SessionWatchRepository{db;constructor(e){this.db=e}insert(e){const s=this.db.prepare(`INSERT INTO session_watches (watcher_session_id, target_session_id, notify, on_events, remaining, created_at)
+         VALUES (?, ?, ?, ?, ?, ?)`).run(e.watcherSessionId,e.targetSessionId,e.notify,JSON.stringify(e.onEvents?.length?e.onEvents:DEFAULT_WATCH_ON),e.times===void 0?1:e.times,new Date().toISOString());return this.getById(Number(s.lastInsertRowid))}getById(e){const s=this.db.prepare("SELECT * FROM session_watches WHERE id = ?").get(e);return s?i(s):void 0}listPendingByTarget(e){return this.db.prepare("SELECT * FROM session_watches WHERE target_session_id = ? AND fired_at IS NULL").all(e).map(i)}listPending(){return this.db.prepare("SELECT * FROM session_watches WHERE fired_at IS NULL ORDER BY id").all().map(i)}consumeHit(e){if(Number(this.db.prepare(`UPDATE session_watches SET remaining = remaining - 1
+           WHERE id = ? AND fired_at IS NULL AND remaining > 0`).run(e).changes)===1)return this.db.prepare("UPDATE session_watches SET fired_at = ? WHERE id = ? AND remaining = 0 AND fired_at IS NULL").run(new Date().toISOString(),e),this.getById(e)??null;const t=this.getById(e);return t&&t.remaining===null&&t.firedAt===null?t:null}updateById(e,s){const t=this.getById(e);if(!(!t||t.firedAt!==null))return this.db.prepare("UPDATE session_watches SET on_events = ?, remaining = ? WHERE id = ? AND fired_at IS NULL").run(JSON.stringify(s.onEvents??t.onEvents),s.remaining,e),this.getById(e)}deleteById(e){return Number(this.db.prepare("DELETE FROM session_watches WHERE id = ?").run(e).changes)===1}deleteBySession(e){return Number(this.db.prepare("DELETE FROM session_watches WHERE target_session_id = ? OR watcher_session_id = ?").run(e,e).changes)}deleteByProject(e){return Number(this.db.prepare(`DELETE FROM session_watches
+           WHERE target_session_id IN (SELECT session_id FROM sessions WHERE project_id = ?)
+              OR watcher_session_id IN (SELECT session_id FROM sessions WHERE project_id = ?)`).run(e,e).changes)}}function i(n){return{id:Number(n.id),watcherSessionId:n.watcher_session_id==null?null:String(n.watcher_session_id),targetSessionId:String(n.target_session_id),onEvents:parseOn(n.on_events),remaining:n.remaining==null?null:Number(n.remaining),notify:n.notify==null?null:String(n.notify),firedAt:n.fired_at==null?null:String(n.fired_at),createdAt:String(n.created_at)}}export function parseOn(n){if(typeof n!="string"||!n)return[...DEFAULT_WATCH_ON];try{const e=JSON.parse(n);if(!Array.isArray(e))return[...DEFAULT_WATCH_ON];const s=e.filter(t=>WATCH_ON_VALUES.includes(t));return s.length?s:[...DEFAULT_WATCH_ON]}catch{return[...DEFAULT_WATCH_ON]}}

package/node_modules/@weavecode/server/dist/repositories/sessions.d.ts

@@ -0,0 +1,85 @@
+import type { DatabaseSync } from 'node:sqlite';
+import { type Harness } from '@weavecode/core';
+export interface SessionRow {
+    sessionId: string;
+    projectId: number | null;
+    /** 已生效的自定义标题（hook sessionTitle / dashboard 改名落地后）。 */
+    title: string | null;
+    /** dashboard 改名待生效：下次 SessionStart(resume)/UserPromptSubmit 时经 hook 下发。 */
+    pendingTitle: string | null;
+    lastSeenAt: string;
+    createdAt: string;
+    /** 该会话的 hook 事件数（listWithCounts 查询填充；其他查询为 undefined）。 */
+    eventCount?: number;
+    /** 会话归属 harness = 最新一条 hook 事件的 source（listWithCounts 查询填充）。 */
+    harness?: Harness | null;
+    /** 回合开合的服务端基线：最后一条 UserPromptSubmit 晚于最后一条 Stop/SessionEnd
+     *  （listWithCounts 查询填充）——前端帧态丢失/重挂载时的权威兜底。 */
+    turnOpen?: boolean;
+    /** 最新一条 hook 事件类型（listWithCounts 查询填充）——web 状态总线判「关闭」
+     *  （SessionEnd）不必再为每个会话拉事件。 */
+    lastEventType?: string | null;
+    /** 自动移除时刻（= lastSeenAt + 该档保留窗；listWithCounts 派生，两档——没等到
+     *  用户 prompt 的新会话快过期，收到过 prompt 的走设置页「无操作会话 n 天后自动
+     *  移除」那条线；会话行剩余存活倒计时即读它）。 */
+    autoDeleteAt?: string | null;
+}
+/** 没等到用户 prompt 的新会话快过期窗（ms）= 1 小时：新建会话要看得见，但无 prompt
+ *  的会话不配占 90 天窗口。 */
+export declare const PROMPTLESS_GRACE_MS: number;
+/**
+ * sessions 表：daemon 自存的会话标题（不写回 Claude Code 内部文件）。
+ * 双向 rename：读 = payload session_title diff；写 = pending_title 经 hook sessionTitle 输出生效。
+ */
+export declare class SessionRepository {
+    private readonly db;
+    constructor(db: DatabaseSync);
+    /** 事件到达时 upsert（刷新 last_seen_at，project_id 首次非空时补上）。 */
+    touch(sessionId: string, projectId?: number | null): SessionRow;
+    getBySessionId(sessionId: string): SessionRow | undefined;
+    list(projectId?: number): SessionRow[];
+    /**
+     * 会话列表 + 事件计数（任务视图左栏用）：LEFT JOIN 一次查出避免 N+1。
+     * 计数不过滤项目（会话可能有跨项目事件），与事件链的 sessionId-only 语义一致。
+     */
+    listWithCounts(projectId?: number): SessionRow[];
+    /**
+     * 单会话 turnOpen（消息域 auto 裁决的忙/闲基准）：语义与 listWithCounts 的
+     * 计算字段完全一致（最后一条 UserPromptSubmit 晚于最后一条 Stop/SessionEnd）。
+     * 会话不存在 → null；存在但零事件 → false（同列表口径：无 ups 即不判开）。
+     */
+    turnOpenOf(sessionId: string): boolean | null;
+    /**
+     * 单会话判活输入（`daemon/claude-liveness.ts` 的 `pidAliveOf` 消费形状）——
+     * harness / lastEventType / eventCount 都是 listWithCounts 的计算字段，单行版与
+     * 列表版同源同判据（同 turnOpenOf 的先例）。会话不存在 → null。
+     */
+    livenessRowOf(sessionId: string): {
+        sessionId: string;
+        harness: Harness | null;
+        lastSeenAt: string;
+        lastEventType: string | null;
+        eventCount: number;
+    } | null;
+    /**
+     * dashboard 改名：display 名（title）立即落，pending_title 负责把新名同步给
+     * Claude 侧（下次 SessionStart(resume)/UserPromptSubmit 经 hook 下发）——dashboard
+     * 不再替闲置会话代持旧名，徽标只表示「Claude 侧还没同步」。
+     * 幂等短路：title 与当前生效名相同 → 不进待生效态（已有 pending 视为撤销，一并清掉）；
+     * 与当前 pending 相同 → 维持 pending 原样返回。只有名称实际变化才写 pending。
+     */
+    setPendingTitle(sessionId: string, title: string): SessionRow | undefined;
+    /**
+     * hook 上报的 session_title diff（兜底自纠通道）：
+     * - 确认主通道 = 交付落定（confirmPendingTitle）：sessionTitle 随 hook 响应下发即视为生效。
+     * - reported diff 分支保留作兜底——会话未真正应用时，下一次上报的旧标题经 diff 通道把
+     *   title 改回（自纠）；pending 存在时忽略外部值（pending 更晚创建）。
+     * - 返回是否发生了标题变化（供 bus 发 session.renamed）。
+     */
+    applyReportedTitle(sessionId: string, reportedTitle: string | null): boolean;
+    /** 交付确认：sessionTitle 已随本次 hook 响应下发——pending 落定为已生效标题。 */
+    confirmPendingTitle(sessionId: string, title: string): boolean;
+    remove(sessionId: string): void;
+    /** 归档项目时清空其全部会话行（事件/派发先清，见归档路由）。 */
+    removeByProject(projectId: number): number;
+}

package/node_modules/@weavecode/server/dist/repositories/sessions.js

@@ -0,0 +1,5 @@
+import{isHarness as _}from"@weavecode/core";import{readDaemonSettingsSync as a,DEFAULT_SESSION_IDLE_DAYS as u}from"../daemon/settings.js";export const PROMPTLESS_GRACE_MS=60*6e4;function p(){return(a().sessions?.idleDays??u)*864e5}export class SessionRepository{db;constructor(e){this.db=e}touch(e,s){const t=new Date().toISOString();return this.db.prepare(`INSERT INTO sessions (session_id, project_id, last_seen_at, created_at)
+         VALUES (?, ?, ?, ?)
+         ON CONFLICT(session_id) DO UPDATE SET
+           last_seen_at = excluded.last_seen_at,
+           project_id = COALESCE(sessions.project_id, excluded.project_id)`).run(e,s??null,t,t),this.getBySessionId(e)}getBySessionId(e){const s=this.db.prepare("SELECT * FROM sessions WHERE session_id = ?").get(e);return s?o(s):void 0}list(e){return(e===void 0?this.db.prepare("SELECT * FROM sessions ORDER BY created_at DESC LIMIT 200").all():this.db.prepare("SELECT * FROM sessions WHERE project_id = ? ORDER BY created_at DESC LIMIT 200").all(e)).map(o)}listWithCounts(e){const s="SELECT s.*, COUNT(e.id) AS event_count, (SELECT e2.source FROM hook_events e2 WHERE e2.session_id = s.session_id ORDER BY e2.id DESC LIMIT 1) AS harness, (SELECT e5.event_type FROM hook_events e5 WHERE e5.session_id = s.session_id ORDER BY e5.id DESC LIMIT 1) AS last_event_type, (SELECT MAX(e3.id) FROM hook_events e3 WHERE e3.session_id = s.session_id AND e3.event_type = 'UserPromptSubmit') AS last_ups, (SELECT MAX(e4.id) FROM hook_events e4 WHERE e4.session_id = s.session_id AND e4.event_type IN ('Stop', 'StopFailure', 'SessionEnd')) AS last_stop FROM sessions s LEFT JOIN hook_events e ON e.session_id = s.session_id";return(e===void 0?this.db.prepare(`${s} GROUP BY s.session_id ORDER BY s.created_at DESC LIMIT 200`).all():this.db.prepare(`${s} WHERE s.project_id = ? GROUP BY s.session_id ORDER BY s.created_at DESC LIMIT 200`).all(e)).map(i=>{const l=i.harness,r=i.last_ups,E=i.last_stop,d=i.last_event_type;return{...o(i),eventCount:Number(i.event_count??0),harness:_(l)?l:null,turnOpen:r!=null&&(E==null||Number(r)>Number(E)),lastEventType:d??null,autoDeleteAt:new Date(Date.parse(String(i.last_seen_at))+(r==null?PROMPTLESS_GRACE_MS:p())).toISOString()}})}turnOpenOf(e){const s=this.db.prepare("SELECT (SELECT MAX(e3.id) FROM hook_events e3 WHERE e3.session_id = ? AND e3.event_type = 'UserPromptSubmit') AS last_ups, (SELECT MAX(e4.id) FROM hook_events e4 WHERE e4.session_id = ? AND e4.event_type IN ('Stop', 'StopFailure', 'SessionEnd')) AS last_stop").get(e,e);if(!this.getBySessionId(e))return null;const t=s?.last_ups??null,i=s?.last_stop??null;return t!=null&&(i==null||Number(t)>Number(i))}livenessRowOf(e){const s=this.db.prepare("SELECT s.session_id, s.last_seen_at, COUNT(e.id) AS event_count, (SELECT e2.source FROM hook_events e2 WHERE e2.session_id = s.session_id ORDER BY e2.id DESC LIMIT 1) AS harness, (SELECT e5.event_type FROM hook_events e5 WHERE e5.session_id = s.session_id ORDER BY e5.id DESC LIMIT 1) AS last_event_type FROM sessions s LEFT JOIN hook_events e ON e.session_id = s.session_id WHERE s.session_id = ? GROUP BY s.session_id").get(e);if(!s)return null;const t=s.harness;return{sessionId:String(s.session_id),harness:_(t)?t:null,lastSeenAt:String(s.last_seen_at),lastEventType:s.last_event_type==null?null:String(s.last_event_type),eventCount:Number(s.event_count??0)}}setPendingTitle(e,s){const t=this.getBySessionId(e);if(t)return t.pendingTitle===s?t:t.title===s?(t.pendingTitle!=null&&this.db.prepare("UPDATE sessions SET pending_title = NULL WHERE session_id = ?").run(e),this.getBySessionId(e)):(this.db.prepare("UPDATE sessions SET title = ?, pending_title = ? WHERE session_id = ?").run(s,s,e),this.getBySessionId(e))}applyReportedTitle(e,s){const t=this.getBySessionId(e);return t?t.pendingTitle!=null?s===t.pendingTitle?(this.db.prepare("UPDATE sessions SET title = ?, pending_title = NULL WHERE session_id = ?").run(s,e),t.title!==s):!1:s!=null&&s!==t.title?(this.db.prepare("UPDATE sessions SET title = ? WHERE session_id = ?").run(s,e),!0):!1:!1}confirmPendingTitle(e,s){return this.db.prepare("UPDATE sessions SET title = ?, pending_title = NULL WHERE session_id = ? AND pending_title = ?").run(s,e,s).changes>0}remove(e){this.db.prepare("DELETE FROM sessions WHERE session_id = ?").run(e)}removeByProject(e){return Number(this.db.prepare("DELETE FROM sessions WHERE project_id = ?").run(e).changes)}}function o(n){return{sessionId:String(n.session_id),projectId:n.project_id==null?null:Number(n.project_id),title:n.title==null?null:String(n.title),pendingTitle:n.pending_title==null?null:String(n.pending_title),lastSeenAt:String(n.last_seen_at),createdAt:String(n.created_at)}}

package/node_modules/@weavecode/server/dist/repositories/uploads.d.ts

@@ -0,0 +1,66 @@
+import type { DatabaseSync } from 'node:sqlite';
+/**
+ * 会话图片上传：文件内容寻址（sha256 = id）落 `<dataDir>/uploads/<id>.<ext>`，
+ * 行只记展示名与媒体类型。**上传 ≠ 投递**——资源不因消息发送而搬家，harness
+ * 拿到的是这个稳定绝对路径（claude 的粘贴处理器按扩展名认出它是图）。
+ * 收的四种类型 = claude 路径识别集 `\.(png|jpe?g|gif|webp)$`（别的类型即使能进
+ * content block 也不进路径文法，v1 不收）。
+ */
+export declare const UPLOAD_MEDIA_TYPES: readonly ["image/png", "image/jpeg", "image/gif", "image/webp"];
+export type UploadMediaType = (typeof UPLOAD_MEDIA_TYPES)[number];
+/** 单张上限：对齐 claude 自己贴图的粘贴缓存上限（~10MB）。 */
+export declare const UPLOAD_MAX_BYTES: number;
+/**
+ * 孤儿回收的宽限期：编辑器里选了图、还没发出去的那份此刻同样「无引用」，
+ * 清理不能把它从用户手上抽走。
+ */
+export declare const UPLOAD_ORPHAN_GRACE_MS: number;
+export interface UploadRow {
+    id: string;
+    mediaType: UploadMediaType;
+    name: string;
+    size: number;
+    createdAt: string;
+}
+export declare class UploadRepository {
+    private readonly db;
+    private readonly dir;
+    constructor(db: DatabaseSync, dir?: string);
+    /**
+     * 落盘 + 登记（内容寻址，重复上传即 no-op）。返回已存行。
+     * 调用方先验过媒体类型与大小，这里只按类型定扩展名。
+     */
+    save(input: {
+        name: string;
+        mediaType: UploadMediaType;
+        bytes: Buffer;
+    }): UploadRow;
+    getById(id: string): UploadRow | undefined;
+    /** 磁盘绝对路径（harness 的 `composePrompt` 引用的就是它）。 */
+    filePath(id: string, mediaType: UploadMediaType): string;
+    /** 投递引用（id + 展示名 + 落盘绝对路径）；任一 id 查不到即 null（整条拒绝）。 */
+    refsOf(ids: readonly string[]): Array<{
+        id: string;
+        name: string;
+        mediaType: string;
+        path: string;
+    }> | null;
+    /** 按行里记的媒体类型反查文件（serve 用；行不存在 / 文件被删 = undefined）。 */
+    fileOf(id: string): {
+        row: UploadRow;
+        bytes: Buffer;
+    } | undefined;
+    /** 挂到开轮事件上（对话气泡的缩略图指针；事件删则级联删）。 */
+    linkToEvent(eventId: number, uploadIds: readonly string[]): void;
+    /**
+     * 孤儿回收：没有任何 `event_images` 引用的上传件（文件 + 行）。图只被会话事件
+     * 引用——事件随会话/项目一起清掉之后就再没有展示面（对话弹窗是事件的投影）。
+     * 返清掉的条数。
+     */
+    pruneUnreferenced(olderThanMs?: number, now?: number): number;
+    /**
+     * 会话各开轮事件随附的图（一次查询，不逐行 join）。
+     * 返回 eventId → 指针表，web 据此把缩略图装到对话条目上。
+     */
+    imagesBySession(sessionId: string): Map<number, UploadRow[]>;
+}

package/node_modules/@weavecode/server/dist/repositories/uploads.js

@@ -0,0 +1,7 @@
+import{createHash as p}from"node:crypto";import{mkdirSync as m,readFileSync as c,writeFileSync as u,existsSync as o,rmSync as g}from"node:fs";import f from"node:path";import{getUploadsDir as h}from"../db/paths.js";export const UPLOAD_MEDIA_TYPES=["image/png","image/jpeg","image/gif","image/webp"],UPLOAD_MAX_BYTES=10*1024*1024,UPLOAD_ORPHAN_GRACE_MS=60*6e4;const l={"image/png":".png","image/jpeg":".jpg","image/gif":".gif","image/webp":".webp"};export class UploadRepository{db;dir;constructor(t,e=h()){this.db=t,this.dir=e}save(t){const e=p("sha256").update(t.bytes).digest("hex");m(this.dir,{recursive:!0});const i=this.filePath(e,t.mediaType);return o(i)||u(i,t.bytes),this.db.prepare(`INSERT INTO uploads (id, media_type, name, size, created_at) VALUES (?, ?, ?, ?, ?)
+         ON CONFLICT(id) DO NOTHING`).run(e,t.mediaType,t.name,t.bytes.length,new Date().toISOString()),this.getById(e)}getById(t){const e=this.db.prepare("SELECT * FROM uploads WHERE id = ?").get(t);return e?a(e):void 0}filePath(t,e){return f.join(this.dir,`${t}${l[e]}`)}refsOf(t){const e=[];for(const i of t){const r=this.getById(i);if(!r)return null;e.push({id:r.id,name:r.name,mediaType:r.mediaType,path:this.filePath(r.id,r.mediaType)})}return e}fileOf(t){const e=this.getById(t);if(!e)return;const i=this.filePath(e.id,e.mediaType);if(o(i))return{row:e,bytes:c(i)}}linkToEvent(t,e){const i=this.db.prepare("INSERT INTO event_images (event_id, upload_id) VALUES (?, ?) ON CONFLICT DO NOTHING");for(const r of e)i.run(t,r)}pruneUnreferenced(t=UPLOAD_ORPHAN_GRACE_MS,e=Date.now()){const i=this.db.prepare(`SELECT id, media_type FROM uploads
+          WHERE created_at <= ? AND id NOT IN (SELECT upload_id FROM event_images)`).all(new Date(e-t).toISOString()),r=this.db.prepare("DELETE FROM uploads WHERE id = ?");for(const d of i)g(this.filePath(d.id,d.media_type),{force:!0}),r.run(d.id);return i.length}imagesBySession(t){const e=this.db.prepare(`SELECT e.event_id AS eventId, u.* FROM event_images e
+           JOIN uploads u ON u.id = e.upload_id
+           JOIN hook_events h ON h.id = e.event_id
+          WHERE h.session_id = ?
+          ORDER BY e.event_id, u.created_at`).all(t),i=new Map;for(const r of e){const d=Number(r.eventId),s=i.get(d)??[];s.push(a(r)),i.set(d,s)}return i}}function a(n){return{id:String(n.id),mediaType:String(n.media_type),name:String(n.name),size:Number(n.size),createdAt:String(n.created_at)}}

package/node_modules/@weavecode/server/dist/statusline/cache-sweeper.d.ts

@@ -0,0 +1,35 @@
+/** 清扫周期：缓存是 KB 级小文件，10 分钟一轮足够跟上会话消亡。 */
+export declare const SWEEP_INTERVAL_MS: number;
+/** 会话缓存多久没被写过算陈旧（会话早已结束，增量扫描状态没意义了）。 */
+export declare const FILE_STALE_MS: number;
+/** 写盘用了 tmp+rename：进程半途死掉会留下它，超过这个时长即回收。 */
+export declare const TMP_STALE_MS: number;
+/** 旧 helper 可能仍在写它们，只回收一小时没动过的（周期跑 = 自愈）。 */
+export declare const LEGACY_STALE_MS: number;
+/**
+ * statusline 渲染缓存的回收器（daemon 侧）。
+ *
+ * 缓存由每次渲染的短命 helper 进程写进 `<dataDir>/statusline/<session>.json`
+ * ——没有常驻进程知道它们何时作废，所以由 daemon 定期扫：清过期条目、删陈旧
+ * 文件与写盘孤儿，并回收旧版散在系统临时目录里的存量。与终端角标刷新器不同，
+ * 这是纯自清理、不推任何帧，故不受「有没有人看」约束。
+ */
+export declare class StatuslineCacheSweeper {
+    private readonly dir;
+    private readonly tmpDir;
+    private readonly now;
+    constructor(dir?: string, tmpDir?: string, now?: () => number);
+    /** 清一轮，返回删掉的文件数（幂等，可反复调用）。 */
+    sweep(): number;
+    private sweepCacheDir;
+    private transcriptLive;
+    /** 迁移期存量：旧版 helper 写在 `os.tmpdir()` 的 `weave-sl*-<hash>.json`。 */
+    private sweepLegacyTmp;
+    /**
+     * 起定时器。同 SessionSweeper：启动即扫一轮（dev 下 tsx watch 重启周期常短于
+     * 间隔，只靠间隔的清扫器赶不上第一拍），unref 不吊住 daemon 退出。
+     */
+    start(): NodeJS.Timeout;
+}
+/** 两个 daemon 入口（start.ts / dev-entry.ts）共用的装配点——防入口漂移。 */
+export declare function startStatuslineCacheSweeper(): NodeJS.Timeout;

package/node_modules/@weavecode/server/dist/statusline/cache-sweeper.js

@@ -0,0 +1 @@
+import{existsSync as y,readdirSync as d,readFileSync as w,renameSync as _,statSync as m,unlinkSync as E,writeFileSync as L}from"node:fs";import x from"node:os";import l from"node:path";import{statuslineCacheDir as j}from"./generator.js";export const SWEEP_INTERVAL_MS=10*6e4,FILE_STALE_MS=1440*6e4,TMP_STALE_MS=60*6e4;const D=["weave-sl-","weave-slc-"];export const LEGACY_STALE_MS=60*6e4;export class StatuslineCacheSweeper{dir;tmpDir;now;constructor(t=j(),e=x.tmpdir(),n=Date.now){this.dir=t,this.tmpDir=e,this.now=n}sweep(){return this.sweepCacheDir()+this.sweepLegacyTmp()}sweepCacheDir(){if(!y(this.dir))return 0;const t=this.now();let e=0;for(const n of S(this.dir)){const r=l.join(this.dir,n);if(n.endsWith(".tmp")){u(r,t,TMP_STALE_MS)&&(c(r),e++);continue}if(!n.endsWith(".json"))continue;if(u(r,t,FILE_STALE_MS)){c(r),e++;continue}let o;try{o=JSON.parse(w(r,"utf8"))}catch{c(r),e++;continue}const a=o.git??{},p=o.tokens??{};let f=!1;for(const[i,h]of Object.entries(a))(!h||typeof h.expires!="number"||h.expires<t)&&(delete a[i],f=!0);for(const i of Object.keys(p))this.transcriptLive(i,t)||(delete p[i],f=!0);if(Object.keys(a).length===0&&Object.keys(p).length===0){c(r),e++;continue}if(f){const i=`${r}.${process.pid}.tmp`;try{L(i,JSON.stringify({...o,git:a,tokens:p})),_(i,r)}catch{}}}return e}transcriptLive(t,e){try{return e-m(t).mtimeMs<=FILE_STALE_MS}catch{return!1}}sweepLegacyTmp(){const t=this.now();let e=0;for(const n of S(this.tmpDir)){if(!n.endsWith(".json")||!D.some(o=>n.startsWith(o)))continue;const r=l.join(this.tmpDir,n);u(r,t,LEGACY_STALE_MS)&&(c(r),e++)}return e}start(){this.sweep();const t=setInterval(()=>this.sweep(),SWEEP_INTERVAL_MS);return t.unref(),t}}export function startStatuslineCacheSweeper(){return new StatuslineCacheSweeper().start()}function S(s){try{return d(s)}catch{return[]}}function u(s,t,e){try{return t-m(s).mtimeMs>e}catch{return!1}}function c(s){try{E(s)}catch{}}