c0de-agent 1.11.0 → 1.13.0

package/dist/core/workflows/discovery.js

@@ -1,11 +1,9 @@
 import { mkdir, readdir, readFile, unlink, writeFile } from 'node:fs/promises';
-import { homedir } from 'node:os';
 import { basename, join } from 'node:path';
 import { pathToFileURL } from 'node:url';
+import { resolveGlobalConfigDir } from '../config.js';
 /** 项目级工作流目录相对路径。 */
 const PROJECT_WORKFLOWS_DIR = '.c0de/workflows';
-/** 用户级（全局）工作流目录：~/.c0de/workflows。 */
-const GLOBAL_WORKFLOWS_DIR = join('.c0de', 'workflows');
 /**
  * 扫描指定目录下的 `*.js` 工作流文件，dynamic import 后转为 WorkflowEntry。
  * import 失败的文件跳过（warn），不阻塞其他工作流加载。
@@ -60,11 +58,11 @@ async function discoverWorkflows(projectDir) {
     return discoverFromDir(join(projectDir, PROJECT_WORKFLOWS_DIR), 'project');
 }
 /**
- * 扫描全局 `~/.c0de/workflows/*.js` 文件，source 标记为 'user'。
- * 目录不存在时返回空数组（与项目级一致）。
+ * 扫描全局工作流目录（默认 `~/.c0de/workflows/*.js`，C0DE_CONFIG_DIR 可重定向），
+ * source 标记为 'user'。目录不存在时返回空数组（与项目级一致）。
  */
 async function discoverGlobalWorkflows() {
-    return discoverFromDir(join(homedir(), GLOBAL_WORKFLOWS_DIR), 'user');
+    return discoverFromDir(join(resolveGlobalConfigDir(), 'workflows'), 'user');
 }
 /** 合法工作流名称：仅小写字母、数字、连字符。 */
 const WORKFLOW_NAME_RE = /^[a-z0-9-]+$/;
@@ -82,7 +80,7 @@ async function saveWorkflow(name, source, target = 'project', projectDir) {
     }
     const dir = target === 'project'
         ? join(projectDir ?? '.', PROJECT_WORKFLOWS_DIR)
-        : join(homedir(), GLOBAL_WORKFLOWS_DIR);
+        : join(resolveGlobalConfigDir(), 'workflows');
     await mkdir(dir, { recursive: true });
     const filePath = join(dir, `${name}.js`);
     await writeFile(filePath, source, 'utf-8');

package/dist/core/workflows/index.d.ts

@@ -4,5 +4,6 @@ export type { SaveResult, SaveTarget } from './discovery.js';
 export { discoverGlobalWorkflows, discoverWorkflows, saveWorkflow } from './discovery.js';
 export type { WorkflowRegistry } from './registry.js';
 export { createAndPopulateRegistry, createWorkflowRegistry, reloadRegistry } from './registry.js';
-export { executeWorkflow } from './runtime.js';
+export { resolveWorkflow } from './resolve.js';
+export { executeWorkflow, workflowSessionTitle } from './runtime.js';
 export type { WorkflowAgentResult, WorkflowContext, WorkflowEntry, WorkflowMeta, WorkflowModule, WorkflowResult, WorkflowSource, WorkflowUtils, } from './types.js';

package/dist/core/workflows/index.js

@@ -2,4 +2,5 @@ export { BUILTIN_WORKFLOWS, createBuiltinWorkflows } from './builtins.js';
 export { buildWorkflowContext } from './context.js';
 export { discoverGlobalWorkflows, discoverWorkflows, saveWorkflow } from './discovery.js';
 export { createAndPopulateRegistry, createWorkflowRegistry, reloadRegistry } from './registry.js';
-export { executeWorkflow } from './runtime.js';
+export { resolveWorkflow } from './resolve.js';
+export { executeWorkflow, workflowSessionTitle } from './runtime.js';

package/dist/core/workflows/registry.d.ts

@@ -10,18 +10,28 @@ declare function createWorkflowRegistry(): {
     clear(): void;
 };
 type WorkflowRegistry = ReturnType<typeof createWorkflowRegistry>;
+type RegistryPopulateOptions = {
+    /**
+     * 项目是否当前可信任（P0 信任边界）：false 时跳过项目级
+     * `.c0de/workflows/*.js` 发现（不 dynamic import 仓库代码）。
+     * 缺省为 false——调用方必须显式确认信任后才放行（fail-closed）。
+     * 内置与全局 `~/.c0de/workflows` 是用户本机显式安装，始终加载。
+     */
+    projectTrusted?: boolean;
+};
 /**
  * 创建并填充工作流注册表（三级发现，后注册覆盖同名）：
  *  1. 注册内置工作流（builtin）
  *  2. 发现并注册全局 `~/.c0de/workflows/*.js`（user）
- *  3. 发现并注册项目 `.c0de/workflows/*.js`（project）
+ *  3. 发现并注册项目 `.c0de/workflows/*.js`（project；仅 projectTrusted 时）
  * 覆盖优先级：project > user > builtin。
  */
-declare function createAndPopulateRegistry(projectDir: string): Promise<WorkflowRegistry>;
+declare function createAndPopulateRegistry(projectDir: string, opts?: RegistryPopulateOptions): Promise<WorkflowRegistry>;
 /**
  * 重新填充已有注册表：清空 → 三级发现 → 注册。
  * 用于 create/save 后热重载，保留同一 registry 引用。
+ * 项目级发现同样受 projectTrusted 门禁（fail-closed）。
  */
-declare function reloadRegistry(registry: WorkflowRegistry, projectDir: string): Promise<void>;
+declare function reloadRegistry(registry: WorkflowRegistry, projectDir: string, opts?: RegistryPopulateOptions): Promise<void>;
 export type { WorkflowRegistry };
 export { createAndPopulateRegistry, createWorkflowRegistry, reloadRegistry };

package/dist/core/workflows/registry.js

@@ -29,10 +29,10 @@ function createWorkflowRegistry() {
  * 创建并填充工作流注册表（三级发现，后注册覆盖同名）：
  *  1. 注册内置工作流（builtin）
  *  2. 发现并注册全局 `~/.c0de/workflows/*.js`（user）
- *  3. 发现并注册项目 `.c0de/workflows/*.js`（project）
+ *  3. 发现并注册项目 `.c0de/workflows/*.js`（project；仅 projectTrusted 时）
  * 覆盖优先级：project > user > builtin。
  */
-async function createAndPopulateRegistry(projectDir) {
+async function createAndPopulateRegistry(projectDir, opts = {}) {
     const registry = createWorkflowRegistry();
     // 1. 内置（由源码字符串动态导入生成，show === run）
     for (const wf of await createBuiltinWorkflows()) {
@@ -43,18 +43,21 @@ async function createAndPopulateRegistry(projectDir) {
     for (const wf of globalWorkflows) {
         registry.register(wf);
     }
-    // 3. 项目级（.c0de/workflows）
-    const projectWorkflows = await discoverWorkflows(projectDir);
-    for (const wf of projectWorkflows) {
-        registry.register(wf);
+    // 3. 项目级（.c0de/workflows）——未信任项目绝不 import（任意代码执行面）
+    if (opts.projectTrusted) {
+        const projectWorkflows = await discoverWorkflows(projectDir);
+        for (const wf of projectWorkflows) {
+            registry.register(wf);
+        }
     }
     return registry;
 }
 /**
  * 重新填充已有注册表：清空 → 三级发现 → 注册。
  * 用于 create/save 后热重载，保留同一 registry 引用。
+ * 项目级发现同样受 projectTrusted 门禁（fail-closed）。
  */
-async function reloadRegistry(registry, projectDir) {
+async function reloadRegistry(registry, projectDir, opts = {}) {
     registry.clear();
     for (const wf of await createBuiltinWorkflows()) {
         registry.register(wf);
@@ -62,8 +65,10 @@ async function reloadRegistry(registry, projectDir) {
     for (const wf of await discoverGlobalWorkflows()) {
         registry.register(wf);
     }
-    for (const wf of await discoverWorkflows(projectDir)) {
-        registry.register(wf);
+    if (opts.projectTrusted) {
+        for (const wf of await discoverWorkflows(projectDir)) {
+            registry.register(wf);
+        }
     }
 }
 export { createAndPopulateRegistry, createWorkflowRegistry, reloadRegistry };

package/dist/core/workflows/resolve.d.ts

@@ -0,0 +1,22 @@
+import type { WorkflowRegistry } from './registry.js';
+import type { WorkflowEntry } from './types.js';
+/**
+ * 统一工作流解析：按「项目（已信任）> 用户 > 内置」优先级查找同名工作流。
+ *
+ * 此前各消费方口径分裂：列表（GET /、/workflow list）项目级覆盖注册表，
+ * 而运行/查看（REST GET /:name、POST /:name/run、chat 斜杠、slash resolveEntry）
+ * 是注册表优先——项目级同名工作流被用户级/内置条目遮蔽，UI 显示项目版、
+ * 实际执行另一份。全部调用点必须经此函数收敛。
+ *
+ * 项目级发现受信任门禁：discoverWorkflows 会 dynamic import 仓库代码
+ * （模块顶层即刻执行），未信任/漂移的项目绝不发现（fail-closed，回退注册表）。
+ */
+declare function resolveWorkflow(opts: {
+    name: string;
+    registry?: WorkflowRegistry | null;
+    /** 项目目录（agent cwd / 项目 worktree）；缺省不发现项目级工作流。 */
+    projectDir?: string;
+    /** 项目当前是否可信（trustedAt + 指纹一致）。false/缺省 → 跳过项目级发现。 */
+    projectTrusted?: boolean;
+}): Promise<WorkflowEntry | undefined>;
+export { resolveWorkflow };

package/dist/core/workflows/resolve.js

@@ -0,0 +1,23 @@
+import { discoverWorkflows } from './discovery.js';
+/**
+ * 统一工作流解析：按「项目（已信任）> 用户 > 内置」优先级查找同名工作流。
+ *
+ * 此前各消费方口径分裂：列表（GET /、/workflow list）项目级覆盖注册表，
+ * 而运行/查看（REST GET /:name、POST /:name/run、chat 斜杠、slash resolveEntry）
+ * 是注册表优先——项目级同名工作流被用户级/内置条目遮蔽，UI 显示项目版、
+ * 实际执行另一份。全部调用点必须经此函数收敛。
+ *
+ * 项目级发现受信任门禁：discoverWorkflows 会 dynamic import 仓库代码
+ * （模块顶层即刻执行），未信任/漂移的项目绝不发现（fail-closed，回退注册表）。
+ */
+async function resolveWorkflow(opts) {
+    const { name, registry, projectDir, projectTrusted } = opts;
+    if (projectDir && projectTrusted) {
+        const discovered = await discoverWorkflows(projectDir);
+        const projectEntry = discovered.find((w) => w.meta.name === name);
+        if (projectEntry)
+            return projectEntry;
+    }
+    return registry?.get(name);
+}
+export { resolveWorkflow };

package/dist/core/workflows/runtime.d.ts

@@ -1,6 +1,11 @@
 import type { AgentDependencies, AgentState, CommandResult } from '../types.js';
 import type { WorkflowRegistry } from './registry.js';
 import type { WorkflowEntry } from './types.js';
+/**
+ * 工作流运行会话标题：`workflow:<name> MM-DD HH:mm`。
+ * 同名工作流多次运行在会话树里可区分，不再是无时间戳的同名行。
+ */
+declare function workflowSessionTitle(name: string, now?: Date): string;
 /** executeWorkflow 的参数。 */
 type ExecuteWorkflowOpts = {
     registry: WorkflowRegistry;
@@ -18,4 +23,4 @@ type ExecuteWorkflowOpts = {
  * 工作流 return 的 output 作为 text 返回；异常捕获为 error。
  */
 declare function executeWorkflow(opts: ExecuteWorkflowOpts): Promise<CommandResult>;
-export { executeWorkflow };
+export { executeWorkflow, workflowSessionTitle };

package/dist/core/workflows/runtime.js

@@ -14,6 +14,14 @@ function createTimeoutPromise(timeoutMs, timeoutSeconds) {
             timer.unref();
     });
 }
+/**
+ * 工作流运行会话标题：`workflow:<name> MM-DD HH:mm`。
+ * 同名工作流多次运行在会话树里可区分，不再是无时间戳的同名行。
+ */
+function workflowSessionTitle(name, now = new Date()) {
+    const pad = (n) => String(n).padStart(2, '0');
+    return `workflow:${name} ${pad(now.getMonth() + 1)}-${pad(now.getDate())} ${pad(now.getHours())}:${pad(now.getMinutes())}`;
+}
 /**
  * 执行工作流：查注册表 → 构建 ctx → 调用 entry.execute → 返回 CommandResult。
  *
@@ -56,9 +64,18 @@ async function executeWorkflow(opts) {
     }
     catch (e) {
         if (e instanceof WorkflowTimeoutError) {
+            // 超时必须真正终止执行，而不是只对用户报错——此前仅 race reject，
+            // 工作流的子 agent 仍在后台继续调 LLM/改文件（继续计费且无中止手柄）。
+            // 与 abortAgent 同语义；内联实现避免 import 循环
+            // （agent.ts → loop.ts → prompt-registry.ts → slash.ts → workflows/index.ts → 本文件）。
+            // 父 abort 经 runSubAgent 的 abort 级联传递给全部子 agent。
+            parent.abortController.abort();
+            if (parent.status._tag === 'running' || parent.status._tag === 'paused') {
+                parent.status = { _tag: 'stopped', reason: 'aborted' };
+            }
             return {
                 _tag: 'error',
-                message: `Workflow "${name}" timed out after ${timeoutSeconds}s`,
+                message: `Workflow "${name}" timed out after ${timeoutSeconds}s（执行已中止）`,
             };
         }
         return {
@@ -67,4 +84,4 @@ async function executeWorkflow(opts) {
         };
     }
 }
-export { executeWorkflow };
+export { executeWorkflow, workflowSessionTitle };

package/dist/db/schema.d.ts

@@ -126,6 +126,40 @@ export declare const projects: import("drizzle-orm/pg-core").PgTableWithColumns<
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        trustedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "trusted_at";
+            tableName: "projects";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        riskFingerprint: import("drizzle-orm/pg-core").PgColumn<{
+            name: "risk_fingerprint";
+            tableName: "projects";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
     };
     dialect: "pg";
 }>;
@@ -307,6 +341,23 @@ export declare const sessions: import("drizzle-orm/pg-core").PgTableWithColumns<
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        deletedBatchId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_batch_id";
+            tableName: "sessions";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
             tableName: "sessions";
@@ -1004,6 +1055,8 @@ export declare const toolMetrics: import("drizzle-orm/pg-core").PgTableWithColum
 /**
  * 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 declare const kanbanBoards: import("drizzle-orm/pg-core").PgTableWithColumns<{
     name: "kanban_boards";
@@ -1033,7 +1086,7 @@ export declare const kanbanBoards: import("drizzle-orm/pg-core").PgTableWithColu
             columnType: "PgText";
             data: string;
             driverParam: string;
-            notNull: true;
+            notNull: false;
             hasDefault: false;
             isPrimaryKey: false;
             isAutoincrement: false;
@@ -1077,6 +1130,74 @@ export declare const kanbanBoards: import("drizzle-orm/pg-core").PgTableWithColu
             identity: undefined;
             generated: undefined;
         }, {}, {}>;
+        deletedAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_at";
+            tableName: "kanban_boards";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deletedProjectName: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_project_name";
+            tableName: "kanban_boards";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        deletedProjectWorktree: import("drizzle-orm/pg-core").PgColumn<{
+            name: "deleted_project_worktree";
+            tableName: "kanban_boards";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        purgePendingAt: import("drizzle-orm/pg-core").PgColumn<{
+            name: "purge_pending_at";
+            tableName: "kanban_boards";
+            dataType: "date";
+            columnType: "PgTimestamp";
+            data: Date;
+            driverParam: string;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
         createdAt: import("drizzle-orm/pg-core").PgColumn<{
             name: "created_at";
             tableName: "kanban_boards";
@@ -1296,6 +1417,253 @@ export declare const kanbanCards: import("drizzle-orm/pg-core").PgTableWithColum
     };
     dialect: "pg";
 }>;
+/**
+ * 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 declare const usageEvents: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "usage_events";
+    schema: undefined;
+    columns: {
+        id: import("drizzle-orm/pg-core").PgColumn<{
+            name: "id";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        callId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "call_id";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        sessionId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "session_id";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgUUID";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        projectId: import("drizzle-orm/pg-core").PgColumn<{
+            name: "project_id";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        provider: import("drizzle-orm/pg-core").PgColumn<{
+            name: "provider";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        model: import("drizzle-orm/pg-core").PgColumn<{
+            name: "model";
+            tableName: "usage_events";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        inputTokens: import("drizzle-orm/pg-core").PgColumn<{
+            name: "input_tokens";
+            tableName: "usage_events";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        outputTokens: import("drizzle-orm/pg-core").PgColumn<{
+            name: "output_tokens";
+            tableName: "usage_events";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        cacheRead: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cache_read";
+            tableName: "usage_events";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: true;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        cost: import("drizzle-orm/pg-core").PgColumn<{
+            name: "cost";
+            tableName: "usage_events";
+            dataType: "number";
+            columnType: "PgReal";
+            data: number;
+            driverParam: string | number;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        timestamp: import("drizzle-orm/pg-core").PgColumn<{
+            name: "timestamp";
+            tableName: "usage_events";
+            dataType: "number";
+            columnType: "PgBigInt53";
+            data: number;
+            driverParam: string | number;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: undefined;
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
+/**
+ * App metadata — 一次性迁移/初始化标记（key-value）。
+ * P3-8：usage backfill 迁移完成后写 'usage_backfill_v1' 标记，
+ * 后续启动跳过全表扫描（导入/备份路径不依赖 backfill 的会话不再产生账本行）。
+ */
+export declare const appMeta: import("drizzle-orm/pg-core").PgTableWithColumns<{
+    name: "app_meta";
+    schema: undefined;
+    columns: {
+        key: import("drizzle-orm/pg-core").PgColumn<{
+            name: "key";
+            tableName: "app_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: true;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+        value: import("drizzle-orm/pg-core").PgColumn<{
+            name: "value";
+            tableName: "app_meta";
+            dataType: "string";
+            columnType: "PgText";
+            data: string;
+            driverParam: string;
+            notNull: true;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {}>;
+    };
+    dialect: "pg";
+}>;
 /** Type exports for insert/select operations. */
 export type ProjectRow = typeof projects.$inferSelect;
 export type ProjectInsert = typeof projects.$inferInsert;
@@ -1313,3 +1681,7 @@ export type KanbanBoardRow = typeof kanbanBoards.$inferSelect;
 export type KanbanBoardInsert = typeof kanbanBoards.$inferInsert;
 export type KanbanCardRow = typeof kanbanCards.$inferSelect;
 export type KanbanCardInsert = typeof kanbanCards.$inferInsert;
+export type UsageEventRow = typeof usageEvents.$inferSelect;
+export type UsageEventInsert = typeof usageEvents.$inferInsert;
+export type AppMetaRow = typeof appMeta.$inferSelect;
+export type AppMetaInsert = typeof appMeta.$inferInsert;