c0de-agent 1.11.0 → 1.13.0

package/dist/db/schema.js

@@ -13,6 +13,14 @@ export const projects = pgTable('projects', {
     gitRemote: text('git_remote'),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
+    /** 用户显式信任该项目作用域配置/插件的时间；null=未信任。
+     *  信任是「克隆即信任」防线的落点：含风险配置（auto 权限/插件）的未信任项目
+     *  在聊天入口被门禁拦截，须显式确认。 */
+    trustedAt: timestamp('trusted_at', { withTimezone: true }).default(sql `null`),
+    /** 信任时项目作用域风险配置的指纹（sha256 over summarizeProjectRisk 输出）。
+     *  用于检测「信任后配置漂移」：仓库后续 git pull 新增 auto 权限/插件/MCP 等
+     *  风险键时，指纹变化 → 重新触发信任门禁，而非永久信任。null=历史记录/无指纹。 */
+    riskFingerprint: text('risk_fingerprint').default(sql `null`),
 });
 /**
  * Sessions table — conversation sessions with branching support.
@@ -31,8 +39,10 @@ export const sessions = pgTable('sessions', {
     worktreePath: text('worktree_path'),
     /** 会话来源：'web'（Web UI）/ 'cli'（CLI print 模式）；null=旧数据视为 web。 */
     source: text('source').default(sql `null`),
-    /** 软删除时间戳；null=未删除。回收站保留 30 天后物理清除。 */
+    /** 软删除时间戳；null=未删除。回收站保留 60 天后物理清除。 */
     deletedAt: timestamp('deleted_at', { withTimezone: true }).default(sql `null`),
+    /** 删除级联批次号：同一次 softDeleteSession 的父+后代共享；恢复时仅还原同批次后代。 */
+    deletedBatchId: uuid('deleted_batch_id'),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
 }, (table) => [
@@ -119,16 +129,26 @@ export const toolMetrics = pgTable('tool_metrics', {
 /**
  * Kanban boards — one per project (unique projectId). Stores column/label
  * configuration as JSON; cards live in kanban_cards.
+ * P2-5：项目删除不再级联销毁看板——projectId 置 null + deletedAt 标记，
+ * 进入回收站「未归属看板」分组，60 天后随清理任务物理清除；恢复时可重新归属。
  */
 export const kanbanBoards = pgTable('kanban_boards', {
     id: uuid('id').primaryKey().defaultRandom(),
-    projectId: text('project_id')
-        .notNull()
-        .references(() => projects.id, { onDelete: 'cascade' }),
+    projectId: text('project_id').references(() => projects.id, { onDelete: 'set null' }),
     /** Column definitions: [{ id, name }] */
     columns: jsonb('columns').notNull(),
     /** Label definitions: [{ id, name, color }] */
     labels: jsonb('labels').notNull().default([]),
+    /** 软删除时间戳；null=活动看板。删除时记录原项目名供回收站展示。 */
+    deletedAt: timestamp('deleted_at', { withTimezone: true }).default(sql `null`),
+    deletedProjectName: text('deleted_project_name'),
+    /** 删除项目时记录的原项目工作目录；null 或目录已不存在时无法「重建原项目」恢复。
+     *  与 deletedProjectName（展示名）分离——name 可能为 null 或重名，路径才是重建依据。 */
+    deletedProjectWorktree: text('deleted_project_worktree'),
+    /** 回收站条目已到期、进入物理清除宽限期的时间戳（null=未到期）。
+     *  到期先标记，宽限期（默认 7 天）内 UI 仍可恢复；期满后由
+     *  purgeDeletedKanbanBoards 物理清除——与会话回收站同策略，杜绝「到期即静默清空」。 */
+    purgePendingAt: timestamp('purge_pending_at', { withTimezone: true }).default(sql `null`),
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
 }, (table) => [uniqueIndex('uq_kanban_boards_project').on(table.projectId)]);
@@ -152,3 +172,39 @@ export const kanbanCards = pgTable('kanban_cards', {
     createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
     updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
 }, (table) => [index('idx_kanban_cards_board').on(table.boardId, table.columnId, table.position)]);
+/**
+ * Usage events — append-only LLM cost ledger (P2 cost accounting decoupled from
+ * session lifecycle). One row per LLM call, written by loop manageSegment.
+ * No FK to sessions/projects: physical purge of sessions (recycle-bin expiry,
+ * manual forever-delete, temp CLI cleanup) must NOT erase spent-cost records —
+ * 成本是账本. sessionId/projectId are denormalized provenance only.
+ */
+export const usageEvents = pgTable('usage_events', {
+    id: uuid('id').primaryKey().defaultRandom(),
+    /** LLM 调用 id（segments 中 LLMCall.id）——唯一约束使 backfill 幂等。 */
+    callId: uuid('call_id').notNull(),
+    sessionId: uuid('session_id'),
+    projectId: text('project_id'),
+    provider: text('provider').notNull(),
+    model: text('model').notNull(),
+    inputTokens: bigint('input_tokens', { mode: 'number' }).notNull().default(0),
+    outputTokens: bigint('output_tokens', { mode: 'number' }).notNull().default(0),
+    cacheRead: bigint('cache_read', { mode: 'number' }).default(0),
+    /** null = 价格未知（按 $0 计入并由聚合层计数提示）。 */
+    cost: real('cost'),
+    /** LLM 请求发起时间（epoch ms）。 */
+    timestamp: bigint('timestamp', { mode: 'number' }).notNull(),
+}, (table) => [
+    uniqueIndex('uq_usage_events_call').on(table.callId),
+    index('idx_usage_events_project_ts').on(table.projectId, table.timestamp),
+    index('idx_usage_events_ts').on(table.timestamp),
+]);
+/**
+ * App metadata — 一次性迁移/初始化标记（key-value）。
+ * P3-8：usage backfill 迁移完成后写 'usage_backfill_v1' 标记，
+ * 后续启动跳过全表扫描（导入/备份路径不依赖 backfill 的会话不再产生账本行）。
+ */
+export const appMeta = pgTable('app_meta', {
+    key: text('key').primaryKey(),
+    value: text('value').notNull(),
+});

package/dist/kanban/index.d.ts

@@ -1 +1,2 @@
-export { createKanbanStore } from './store.js';
+export type { DeletedKanbanBoard, KanbanTrashPurgeResult, MergeKanbanBoardResult, RestoreKanbanBoardResult, } from './store.js';
+export { createKanbanStore, getDeletedKanbanBoard, KanbanCardNotFoundError, KanbanColumnInUseError, KanbanColumnNotFoundError, KanbanInvalidPriorityError, listDeletedKanbanBoards, mergeKanbanBoard, permanentlyDeleteKanbanBoard, purgeDeletedKanbanBoards, restoreKanbanBoard, softDeleteKanbanBoard, } from './store.js';

package/dist/kanban/index.js

@@ -1 +1 @@
-export { createKanbanStore } from './store.js';
+export { createKanbanStore, getDeletedKanbanBoard, KanbanCardNotFoundError, KanbanColumnInUseError, KanbanColumnNotFoundError, KanbanInvalidPriorityError, listDeletedKanbanBoards, mergeKanbanBoard, permanentlyDeleteKanbanBoard, purgeDeletedKanbanBoards, restoreKanbanBoard, softDeleteKanbanBoard, } from './store.js';

package/dist/kanban/store.d.ts

@@ -1,8 +1,94 @@
 import type { DB } from '../db/client.js';
 import type { KanbanStore } from '../shared/types/kanban.js';
+/** 列内仍有卡片时禁止删除该列（否则卡片静默不可见）。 */
+declare class KanbanColumnInUseError extends Error {
+    constructor(columnNames: string[], cardCount: number, cardIds?: string[]);
+}
+/**
+ * 目标列不存在（add/move 引用未配置的列）——与 import/删列的悬空列防护同口径：
+ * 此前运行时 add/move 不校验，LLM 幻觉列名写入后卡片静默不可见，且幽灵卡片
+ * 会反过来冻结列配置删除（KanbanColumnInUseError 死锁）。
+ * 错误信息回传可用列清单，供 LLM 自纠而非再猜。
+ */
+declare class KanbanColumnNotFoundError extends Error {
+    readonly columnId: string;
+    constructor(columnId: string, availableColumns: string[], op: 'add' | 'move');
+}
+/** 非法优先级（REST PATCH / kanbanTool 透传未校验值）。 */
+declare class KanbanInvalidPriorityError extends Error {
+    readonly value: string;
+    constructor(value: string);
+}
+/** 卡片不存在（update/move 目标 id 无效）。 */
+declare class KanbanCardNotFoundError extends Error {
+    readonly cardId: string;
+    constructor(cardId: string);
+}
 /**
  * Create a project-scoped KanbanStore backed by the given db handle.
  * The board is created on first access (lazy) with the default 5 columns.
  */
 declare function createKanbanStore(handle: DB, projectId: string): KanbanStore;
-export { createKanbanStore };
+export { createKanbanStore, KanbanCardNotFoundError, KanbanColumnInUseError, KanbanColumnNotFoundError, KanbanInvalidPriorityError, };
+/** 回收站条目信息（列表展示用）。 */
+export type DeletedKanbanBoard = {
+    id: string;
+    /** 删除时记录的原项目名（项目行已删除，无法再 join）。 */
+    projectName: string;
+    cardCount: number;
+    deletedAt: number;
+    /** 已到期进入物理清除宽限期的时间戳（ms）；null=尚未到期。 */
+    purgePendingAt: number | null;
+    /** 删除时记录的原项目工作目录；null 或目录已不存在时无法「重建原项目」恢复。 */
+    deletedProjectWorktree: string | null;
+};
+/** 把活动看板软删除进回收站（记录原项目名与工作目录）。项目行删除后 FK 将 projectId 置 null。 */
+export declare function softDeleteKanbanBoard(handle: DB, projectId: string, projectName: string | null, worktree?: string | null): Promise<boolean>;
+/** 回收站看板列表（含卡片数）。 */
+export declare function listDeletedKanbanBoards(handle: DB): Promise<DeletedKanbanBoard[]>;
+/** 按 id 取单个回收站看板（供「重建原项目」恢复读取原工作目录）。 */
+export declare function getDeletedKanbanBoard(handle: DB, boardId: string): Promise<DeletedKanbanBoard | null>;
+export type RestoreKanbanBoardResult = {
+    ok: true;
+} | {
+    ok: false;
+    reason: 'BOARD_NOT_FOUND' | 'TARGET_HAS_BOARD';
+};
+/** 恢复看板到指定项目：目标项目已有活动看板 → 409 语义（不覆盖用户现有看板）。
+ *  P2 修复：检查与更新放进单事务，并发下撞 uq_kanban_boards_project 唯一索引时
+ *  降级为 TARGET_HAS_BOARD（此前抛 PG 错误 500）。 */
+export declare function restoreKanbanBoard(handle: DB, boardId: string, projectId: string): Promise<RestoreKanbanBoardResult>;
+export type MergeKanbanBoardResult = {
+    ok: true;
+    mergedColumns: number;
+    mergedCards: number;
+} | {
+    ok: false;
+    reason: 'BOARD_NOT_FOUND';
+};
+/**
+ * P1 修复：把回收站看板合并进目标项目的活动看板（TARGET_HAS_BOARD 死胡同的出口）。
+ * 此前「目标项目已有看板」时恢复 409，而产品没有删除活动看板的能力，用户无法
+ * 把旧项目卡片拿回现有项目——现在 merge 模式下：
+ *  - 目标无活动看板 → 等价普通恢复（重新归属）；
+ *  - 目标有活动看板 → 追加缺失列，卡片并入对应列末尾（position 重新计算避免
+ *    与目标卡片重叠）；源卡片引用源板已不存在列时落到目标第一列（保证可见）；
+ *  - 合并成功后源看板物理删除（卡片已迁移，FK cascade 清源卡）。
+ * 全程单事务：失败整体回滚，不残留半合并状态。
+ */
+export declare function mergeKanbanBoard(handle: DB, boardId: string, projectId: string): Promise<MergeKanbanBoardResult>;
+/** 回收站内彻底删除看板（不可恢复）。 */
+export declare function permanentlyDeleteKanbanBoard(handle: DB, boardId: string): Promise<number>;
+/** 两阶段清理结果：marked = 本次新标记进入宽限期的条目数；deleted = 本次物理清除数。 */
+export type KanbanTrashPurgeResult = {
+    marked: number;
+    deleted: number;
+};
+/**
+ * 看板回收站两阶段清理（与会话 purgeDeletedSessions 同策略，杜绝「到期即静默清空」）：
+ *  - 阶段一：软删除超过 retentionMs 且尚未标记 → 写 purgePendingAt（进入宽限期，
+ *    UI 显示「即将清除」仍可恢复）；
+ *  - 阶段二：purgePendingAt 早于 graceMs 截止 → 物理清除（卡片经 FK cascade 连带删除）。
+ * 看板回收站全局单一分组、无「首次查看才起算」语义，保留期自删除时刻起算，稳定可预期。
+ */
+export declare function purgeDeletedKanbanBoards(handle: DB, retentionMs: number, graceMs: number): Promise<KanbanTrashPurgeResult>;