autosnippet 3.3.7 → 3.3.9

package/dist/lib/repository/code/CodeEntityRepository.d.ts

@@ -0,0 +1,91 @@
+/**
+ * CodeEntityRepository — AST 代码实体的仓储实现
+ *
+ * 从 CodeEntityGraph 和 PanoramaScanner 提取的数据操作，
+ * 使用 Drizzle 类型安全 API。
+ */
+import { codeEntities } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+export interface CodeEntity {
+    id: number;
+    entityId: string;
+    entityType: string;
+    projectRoot: string;
+    name: string;
+    filePath: string | null;
+    lineNumber: number | null;
+    superclass: string | null;
+    protocols: string[];
+    metadata: Record<string, unknown>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface CodeEntityInsert {
+    entityId: string;
+    entityType: string;
+    projectRoot: string;
+    name: string;
+    filePath?: string | null;
+    lineNumber?: number | null;
+    superclass?: string | null;
+    protocols?: string[];
+    metadata?: Record<string, unknown>;
+}
+export declare class CodeEntityRepositoryImpl extends RepositoryBase<typeof codeEntities, CodeEntity> {
+    #private;
+    constructor(drizzle: ConstructorParameters<typeof RepositoryBase<typeof codeEntities, CodeEntity>>[0]);
+    findById(id: number): Promise<CodeEntity | null>;
+    create(data: CodeEntityInsert): Promise<CodeEntity>;
+    delete(id: number): Promise<boolean>;
+    /** UPSERT — 按 (entityId, entityType, projectRoot) 唯一约束 */
+    upsert(entity: CodeEntityInsert): Promise<CodeEntity>;
+    /** 批量 UPSERT */
+    batchUpsert(entities: CodeEntityInsert[]): Promise<number>;
+    /** 按文件路径查询 */
+    findByFile(filePath: string, projectRoot: string): Promise<CodeEntity[]>;
+    /** 按实体类型列表 */
+    listByType(entityType: string, projectRoot: string, limit?: number): Promise<CodeEntity[]>;
+    /** 按名称搜索 */
+    searchByName(query: string, projectRoot: string, options?: {
+        entityType?: string;
+        limit?: number;
+    }): Promise<CodeEntity[]>;
+    /** 按 entityId + entityType + projectRoot 精确查找 */
+    findByEntityId(entityId: string, entityType: string, projectRoot: string): Promise<CodeEntity | null>;
+    /** 删除指定项目的所有实体 */
+    clearProject(projectRoot: string): Promise<number>;
+    /** 删除指定文件的实体（用于增量更新调用图） */
+    deleteByFile(filePath: string, projectRoot: string): Promise<number>;
+    /** 获取实体总数 */
+    getEntityCount(projectRoot?: string): Promise<number>;
+    /** 按类型统计实体数 */
+    countByType(projectRoot: string): Promise<Record<string, number>>;
+    /** 按文件路径和实体类型删除 */
+    deleteByFileAndType(filePath: string, entityType: string, projectRoot: string): Promise<number>;
+    /** 按 entityId + projectRoot 查找（不限 entityType） */
+    findByEntityIdOnly(entityId: string, projectRoot: string): Promise<CodeEntity | null>;
+    /** 查询非 module 实体的 (entityId, filePath) 去重列表 */
+    findDistinctEntityIdsWithFilePath(projectRoot: string): Promise<Array<{
+        entityId: string;
+        filePath: string;
+    }>>;
+    /** 查询本地模块 (排除 external/host nodeType) */
+    findLocalModules(projectRoot: string): Promise<Array<{
+        entityId: string;
+        name: string;
+    }>>;
+    /** 查询指定 nodeType 的模块实体 */
+    findModulesByNodeTypes(projectRoot: string, nodeTypes: string[]): Promise<CodeEntity[]>;
+    /** 统计指定 nodeType 的模块数量 */
+    countModulesByNodeType(projectRoot: string, nodeType: string): Promise<number>;
+    /** 按 projectRoot + filePaths 批量查询实体 */
+    findByProjectAndFilePaths(projectRoot: string, filePaths: string[]): Promise<CodeEntity[]>;
+    /** 查询非 module 实体的去重文件路径列表 */
+    findDistinctFilePaths(projectRoot: string, limit?: number): Promise<string[]>;
+    /** 批量 INSERT OR IGNORE (不更新已存在的行) */
+    batchInsertIgnore(entities: CodeEntityInsert[]): Promise<number>;
+    /**
+     * 符号名是否存在 (ReverseGuard.#symbolExists)
+     */
+    existsByName(name: string): boolean;
+}

package/dist/lib/repository/code/CodeEntityRepository.js

@@ -0,0 +1,361 @@
+/**
+ * CodeEntityRepository — AST 代码实体的仓储实现
+ *
+ * 从 CodeEntityGraph 和 PanoramaScanner 提取的数据操作，
+ * 使用 Drizzle 类型安全 API。
+ */
+import { and, count, eq, inArray, isNotNull, like, ne, sql } from 'drizzle-orm';
+import { codeEntities } from '../../infrastructure/database/drizzle/schema.js';
+import { unixNow } from '../../shared/utils/common.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+/* ═══ Repository 实现 ═══ */
+export class CodeEntityRepositoryImpl extends RepositoryBase {
+    constructor(drizzle) {
+        super(drizzle, codeEntities);
+    }
+    /* ─── CRUD ─── */
+    async findById(id) {
+        const rows = this.drizzle.select().from(this.table).where(eq(this.table.id, id)).limit(1).all();
+        return rows.length > 0 ? this.#mapRow(rows[0]) : null;
+    }
+    async create(data) {
+        return this.upsert(data);
+    }
+    async delete(id) {
+        const result = this.drizzle.delete(this.table).where(eq(this.table.id, id)).run();
+        return result.changes > 0;
+    }
+    /* ─── 核心操作 ─── */
+    /** UPSERT — 按 (entityId, entityType, projectRoot) 唯一约束 */
+    async upsert(entity) {
+        const now = unixNow();
+        const protocolsJson = JSON.stringify(entity.protocols ?? []);
+        const metaJson = JSON.stringify(entity.metadata ?? {});
+        this.drizzle
+            .insert(this.table)
+            .values({
+            entityId: entity.entityId,
+            entityType: entity.entityType,
+            projectRoot: entity.projectRoot,
+            name: entity.name,
+            filePath: entity.filePath ?? null,
+            lineNumber: entity.lineNumber ?? null,
+            superclass: entity.superclass ?? null,
+            protocols: protocolsJson,
+            metadataJson: metaJson,
+            createdAt: now,
+            updatedAt: now,
+        })
+            .onConflictDoUpdate({
+            target: [this.table.entityId, this.table.entityType, this.table.projectRoot],
+            set: {
+                name: entity.name,
+                filePath: sql `${entity.filePath ?? null}`,
+                lineNumber: sql `${entity.lineNumber ?? null}`,
+                superclass: sql `${entity.superclass ?? null}`,
+                protocols: protocolsJson,
+                metadataJson: metaJson,
+                updatedAt: now,
+            },
+        })
+            .run();
+        // 返回 upserted 行
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.entityId, entity.entityId), eq(this.table.entityType, entity.entityType), eq(this.table.projectRoot, entity.projectRoot)))
+            .limit(1)
+            .all();
+        return this.#mapRow(rows[0]);
+    }
+    /** 批量 UPSERT */
+    async batchUpsert(entities) {
+        if (entities.length === 0) {
+            return 0;
+        }
+        let upserted = 0;
+        this.transaction((tx) => {
+            const now = unixNow();
+            for (const entity of entities) {
+                tx.insert(this.table)
+                    .values({
+                    entityId: entity.entityId,
+                    entityType: entity.entityType,
+                    projectRoot: entity.projectRoot,
+                    name: entity.name,
+                    filePath: entity.filePath ?? null,
+                    lineNumber: entity.lineNumber ?? null,
+                    superclass: entity.superclass ?? null,
+                    protocols: JSON.stringify(entity.protocols ?? []),
+                    metadataJson: JSON.stringify(entity.metadata ?? {}),
+                    createdAt: now,
+                    updatedAt: now,
+                })
+                    .onConflictDoUpdate({
+                    target: [this.table.entityId, this.table.entityType, this.table.projectRoot],
+                    set: {
+                        name: entity.name,
+                        filePath: sql `${entity.filePath ?? null}`,
+                        lineNumber: sql `${entity.lineNumber ?? null}`,
+                        superclass: sql `${entity.superclass ?? null}`,
+                        protocols: JSON.stringify(entity.protocols ?? []),
+                        metadataJson: JSON.stringify(entity.metadata ?? {}),
+                        updatedAt: now,
+                    },
+                })
+                    .run();
+                upserted++;
+            }
+        });
+        return upserted;
+    }
+    /* ─── 查询 ─── */
+    /** 按文件路径查询 */
+    async findByFile(filePath, projectRoot) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.filePath, filePath), eq(this.table.projectRoot, projectRoot)))
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 按实体类型列表 */
+    async listByType(entityType, projectRoot, limit = 100) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.entityType, entityType), eq(this.table.projectRoot, projectRoot)))
+            .orderBy(this.table.name)
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 按名称搜索 */
+    async searchByName(query, projectRoot, options = {}) {
+        const { entityType, limit = 50 } = options;
+        const conditions = [
+            eq(this.table.projectRoot, projectRoot),
+            like(this.table.name, `%${query}%`),
+        ];
+        if (entityType) {
+            conditions.push(eq(this.table.entityType, entityType));
+        }
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(...conditions))
+            .orderBy(this.table.name)
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 按 entityId + entityType + projectRoot 精确查找 */
+    async findByEntityId(entityId, entityType, projectRoot) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.entityId, entityId), eq(this.table.entityType, entityType), eq(this.table.projectRoot, projectRoot)))
+            .limit(1)
+            .all();
+        return rows.length > 0 ? this.#mapRow(rows[0]) : null;
+    }
+    /** 删除指定项目的所有实体 */
+    async clearProject(projectRoot) {
+        const result = this.drizzle
+            .delete(this.table)
+            .where(eq(this.table.projectRoot, projectRoot))
+            .run();
+        return result.changes;
+    }
+    /** 删除指定文件的实体（用于增量更新调用图） */
+    async deleteByFile(filePath, projectRoot) {
+        const result = this.drizzle
+            .delete(this.table)
+            .where(and(eq(this.table.filePath, filePath), eq(this.table.projectRoot, projectRoot)))
+            .run();
+        return result.changes;
+    }
+    /** 获取实体总数 */
+    async getEntityCount(projectRoot) {
+        const condition = projectRoot ? eq(this.table.projectRoot, projectRoot) : undefined;
+        const [row] = this.drizzle.select({ cnt: count() }).from(this.table).where(condition).all();
+        return row?.cnt ?? 0;
+    }
+    /** 按类型统计实体数 */
+    async countByType(projectRoot) {
+        const rows = this.drizzle
+            .select({
+            entityType: this.table.entityType,
+            cnt: count(),
+        })
+            .from(this.table)
+            .where(eq(this.table.projectRoot, projectRoot))
+            .groupBy(this.table.entityType)
+            .all();
+        const result = {};
+        for (const row of rows) {
+            result[row.entityType] = row.cnt;
+        }
+        return result;
+    }
+    /** 按文件路径和实体类型删除 */
+    async deleteByFileAndType(filePath, entityType, projectRoot) {
+        const result = this.drizzle
+            .delete(this.table)
+            .where(and(eq(this.table.filePath, filePath), eq(this.table.entityType, entityType), eq(this.table.projectRoot, projectRoot)))
+            .run();
+        return result.changes;
+    }
+    /** 按 entityId + projectRoot 查找（不限 entityType） */
+    async findByEntityIdOnly(entityId, projectRoot) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.entityId, entityId), eq(this.table.projectRoot, projectRoot)))
+            .limit(1)
+            .all();
+        return rows.length > 0 ? this.#mapRow(rows[0]) : null;
+    }
+    /* ─── Panorama 域查询 (Phase 5e) ─── */
+    /** 查询非 module 实体的 (entityId, filePath) 去重列表 */
+    async findDistinctEntityIdsWithFilePath(projectRoot) {
+        const rows = this.drizzle
+            .selectDistinct({
+            entityId: this.table.entityId,
+            filePath: this.table.filePath,
+        })
+            .from(this.table)
+            .where(and(eq(this.table.projectRoot, projectRoot), isNotNull(this.table.filePath), ne(this.table.entityType, 'module')))
+            .all();
+        return rows.filter((r) => r.filePath !== null);
+    }
+    /** 查询本地模块 (排除 external/host nodeType) */
+    async findLocalModules(projectRoot) {
+        const rows = this.drizzle
+            .selectDistinct({
+            entityId: this.table.entityId,
+            name: this.table.name,
+        })
+            .from(this.table)
+            .where(and(eq(this.table.entityType, 'module'), eq(this.table.projectRoot, projectRoot), sql `COALESCE(json_extract(${this.table.metadataJson}, '$.nodeType'), 'local') NOT IN ('external', 'host')`))
+            .all();
+        return rows;
+    }
+    /** 查询指定 nodeType 的模块实体 */
+    async findModulesByNodeTypes(projectRoot, nodeTypes) {
+        if (nodeTypes.length === 0) {
+            return [];
+        }
+        const placeholders = nodeTypes.map((t) => `'${t.replace(/'/g, "''")}'`).join(', ');
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.entityType, 'module'), eq(this.table.projectRoot, projectRoot), sql `json_extract(${this.table.metadataJson}, '$.nodeType') IN (${sql.raw(placeholders)})`))
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 统计指定 nodeType 的模块数量 */
+    async countModulesByNodeType(projectRoot, nodeType) {
+        const [row] = this.drizzle
+            .select({ cnt: count() })
+            .from(this.table)
+            .where(and(eq(this.table.entityType, 'module'), eq(this.table.projectRoot, projectRoot), sql `json_extract(${this.table.metadataJson}, '$.nodeType') = ${nodeType}`))
+            .all();
+        return row?.cnt ?? 0;
+    }
+    /** 按 projectRoot + filePaths 批量查询实体 */
+    async findByProjectAndFilePaths(projectRoot, filePaths) {
+        if (filePaths.length === 0) {
+            return [];
+        }
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.projectRoot, projectRoot), inArray(this.table.filePath, filePaths)))
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 查询非 module 实体的去重文件路径列表 */
+    async findDistinctFilePaths(projectRoot, limit = 2000) {
+        const rows = this.drizzle
+            .selectDistinct({ filePath: this.table.filePath })
+            .from(this.table)
+            .where(and(eq(this.table.projectRoot, projectRoot), isNotNull(this.table.filePath), ne(this.table.entityType, 'module')))
+            .limit(limit)
+            .all();
+        return rows.filter((r) => r.filePath !== null).map((r) => r.filePath);
+    }
+    /** 批量 INSERT OR IGNORE (不更新已存在的行) */
+    async batchInsertIgnore(entities) {
+        if (entities.length === 0) {
+            return 0;
+        }
+        let inserted = 0;
+        const now = unixNow();
+        this.transaction((tx) => {
+            for (const entity of entities) {
+                tx.insert(this.table)
+                    .values({
+                    entityId: entity.entityId,
+                    entityType: entity.entityType,
+                    projectRoot: entity.projectRoot,
+                    name: entity.name,
+                    filePath: entity.filePath ?? null,
+                    lineNumber: entity.lineNumber ?? null,
+                    superclass: entity.superclass ?? null,
+                    protocols: JSON.stringify(entity.protocols ?? []),
+                    metadataJson: JSON.stringify(entity.metadata ?? {}),
+                    createdAt: now,
+                    updatedAt: now,
+                })
+                    .onConflictDoNothing()
+                    .run();
+                inserted++;
+            }
+        });
+        return inserted;
+    }
+    /**
+     * 符号名是否存在 (ReverseGuard.#symbolExists)
+     */
+    existsByName(name) {
+        const row = this.drizzle
+            .select({ name: this.table.name })
+            .from(this.table)
+            .where(eq(this.table.name, name))
+            .limit(1)
+            .get();
+        return row != null;
+    }
+    /* ─── 内部辅助 ─── */
+    #mapRow(row) {
+        let protocols = [];
+        let metadata = {};
+        try {
+            protocols = JSON.parse(row.protocols ?? '[]');
+        }
+        catch {
+            /* ignore */
+        }
+        try {
+            metadata = JSON.parse(row.metadataJson ?? '{}');
+        }
+        catch {
+            /* ignore */
+        }
+        return {
+            id: row.id,
+            entityId: row.entityId,
+            entityType: row.entityType,
+            projectRoot: row.projectRoot,
+            name: row.name,
+            filePath: row.filePath,
+            lineNumber: row.lineNumber,
+            superclass: row.superclass,
+            protocols,
+            metadata,
+            createdAt: row.createdAt,
+            updatedAt: row.updatedAt,
+        };
+    }
+}

package/dist/lib/repository/delivery/DeliveryRepoAdapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DeliveryRepoAdapter — CursorDeliveryPipeline 用的仓储适配器
+ *
+ * 将 call graph 分析中的 raw SQL 查询封装在 lib/repository/ 层。
+ */
+type RawDb = {
+    prepare(sql: string): {
+        all(...args: unknown[]): Array<Record<string, unknown>>;
+    };
+};
+/** CursorDeliveryPipeline call graph 分析所需的最小接口 */
+export interface CallGraphRepo {
+    /** 查询 phase5 调用边 */
+    findCallEdges(): Array<{
+        from_id: string;
+        to_id: string;
+        metadata_json: string;
+    }>;
+    /** 查询方法级代码实体的 entity_id + file_path */
+    findMethodEntities(): Array<{
+        entity_id: string;
+        file_path: string;
+    }>;
+}
+/** Raw-db 适配器：实现 CallGraphRepo 接口 */
+export declare class RawDbCallGraphAdapter implements CallGraphRepo {
+    #private;
+    constructor(db: RawDb);
+    findCallEdges(): Array<{
+        from_id: string;
+        to_id: string;
+        metadata_json: string;
+    }>;
+    findMethodEntities(): Array<{
+        entity_id: string;
+        file_path: string;
+    }>;
+}
+export {};

package/dist/lib/repository/delivery/DeliveryRepoAdapter.js

@@ -0,0 +1,23 @@
+/**
+ * DeliveryRepoAdapter — CursorDeliveryPipeline 用的仓储适配器
+ *
+ * 将 call graph 分析中的 raw SQL 查询封装在 lib/repository/ 层。
+ */
+/** Raw-db 适配器：实现 CallGraphRepo 接口 */
+export class RawDbCallGraphAdapter {
+    #db;
+    constructor(db) {
+        this.#db = db;
+    }
+    findCallEdges() {
+        return this.#db
+            .prepare(`SELECT from_id, to_id, metadata_json FROM knowledge_edges
+         WHERE relation = 'calls' AND metadata_json LIKE '%phase5%'`)
+            .all();
+    }
+    findMethodEntities() {
+        return this.#db
+            .prepare(`SELECT entity_id, file_path FROM code_entities WHERE entity_type = 'method'`)
+            .all();
+    }
+}

package/dist/lib/repository/evolution/LifecycleEventRepository.d.ts

@@ -0,0 +1,51 @@
+/**
+ * LifecycleEventRepository — lifecycle_transition_events 表 CRUD (Drizzle ORM)
+ *
+ * 操作 lifecycle_transition_events 表，存储 Recipe 生命周期状态转移事件。
+ *
+ * Drizzle 迁移策略：
+ *   - 替代 RecipeLifecycleSupervisor 中的所有 rawDb.prepare() 调用
+ *   - 消除 12 个 escape-hatch 注解
+ */
+import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
+import type { TransitionEvent, TransitionEvidence } from '../../types/evolution.js';
+export interface RecordEventInput {
+    id: string;
+    recipeId: string;
+    fromState: string;
+    toState: string;
+    trigger: string;
+    operatorId: string;
+    evidence: TransitionEvidence | null;
+    proposalId: string | null;
+    createdAt: number;
+}
+export interface TransitionEventRow {
+    id: string;
+    recipeId: string;
+    fromState: string;
+    toState: string;
+    trigger: TransitionEvent['trigger'];
+    operatorId: string;
+    evidence: TransitionEvidence | null;
+    proposalId: string | null;
+    createdAt: number;
+}
+export declare class LifecycleEventRepository {
+    #private;
+    constructor(drizzle: DrizzleDB);
+    record(input: RecordEventInput): void;
+    /** 获取指定 Recipe 的转移历史（按时间倒序） */
+    getHistory(recipeId: string, limit?: number): TransitionEvent[];
+    /** 统计指定时间之后的事件数量 */
+    countSince(since: number): number;
+    /** 按 trigger 分组统计（限定时间窗口，按数量倒序前 N） */
+    topTriggersSince(since: number, limit?: number): {
+        trigger: string;
+        count: number;
+    }[];
+    /** 按 trigger 值统计数量 */
+    countByTrigger(trigger: string): number;
+    /** 按多个 trigger 值统计数量 */
+    countByTriggers(triggers: string[]): number;
+}

package/dist/lib/repository/evolution/LifecycleEventRepository.js

@@ -0,0 +1,119 @@
+/**
+ * LifecycleEventRepository — lifecycle_transition_events 表 CRUD (Drizzle ORM)
+ *
+ * 操作 lifecycle_transition_events 表，存储 Recipe 生命周期状态转移事件。
+ *
+ * Drizzle 迁移策略：
+ *   - 替代 RecipeLifecycleSupervisor 中的所有 rawDb.prepare() 调用
+ *   - 消除 12 个 escape-hatch 注解
+ */
+import { count, desc, eq, gt, sql } from 'drizzle-orm';
+import { lifecycleTransitionEvents } from '../../infrastructure/database/drizzle/schema.js';
+/* ────────────────────── Class ────────────────────── */
+export class LifecycleEventRepository {
+    #drizzle;
+    constructor(drizzle) {
+        this.#drizzle = drizzle;
+    }
+    /* ═══════════════════ Write ═══════════════════ */
+    record(input) {
+        this.#drizzle
+            .insert(lifecycleTransitionEvents)
+            .values({
+            id: input.id,
+            recipeId: input.recipeId,
+            fromState: input.fromState,
+            toState: input.toState,
+            trigger: input.trigger,
+            operatorId: input.operatorId,
+            evidenceJson: input.evidence ? JSON.stringify(input.evidence) : null,
+            proposalId: input.proposalId,
+            createdAt: input.createdAt,
+        })
+            .run();
+    }
+    /* ═══════════════════ Read ═══════════════════ */
+    /** 获取指定 Recipe 的转移历史（按时间倒序） */
+    getHistory(recipeId, limit = 50) {
+        const rows = this.#drizzle
+            .select()
+            .from(lifecycleTransitionEvents)
+            .where(eq(lifecycleTransitionEvents.recipeId, recipeId))
+            .orderBy(desc(lifecycleTransitionEvents.createdAt))
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 统计指定时间之后的事件数量 */
+    countSince(since) {
+        const result = this.#drizzle
+            .select({ cnt: count() })
+            .from(lifecycleTransitionEvents)
+            .where(gt(lifecycleTransitionEvents.createdAt, since))
+            .get();
+        return result?.cnt ?? 0;
+    }
+    /** 按 trigger 分组统计（限定时间窗口，按数量倒序前 N） */
+    topTriggersSince(since, limit = 5) {
+        const rows = this.#drizzle
+            .select({
+            trigger: lifecycleTransitionEvents.trigger,
+            cnt: count(),
+        })
+            .from(lifecycleTransitionEvents)
+            .where(gt(lifecycleTransitionEvents.createdAt, since))
+            .groupBy(lifecycleTransitionEvents.trigger)
+            .orderBy(sql `count(*) desc`)
+            .limit(limit)
+            .all();
+        return rows.map((r) => ({ trigger: r.trigger, count: r.cnt }));
+    }
+    /** 按 trigger 值统计数量 */
+    countByTrigger(trigger) {
+        const result = this.#drizzle
+            .select({ cnt: count() })
+            .from(lifecycleTransitionEvents)
+            .where(eq(lifecycleTransitionEvents.trigger, trigger))
+            .get();
+        return result?.cnt ?? 0;
+    }
+    /** 按多个 trigger 值统计数量 */
+    countByTriggers(triggers) {
+        if (triggers.length === 0) {
+            return 0;
+        }
+        // Build OR condition for multiple triggers
+        const result = this.#drizzle
+            .select({ cnt: count() })
+            .from(lifecycleTransitionEvents)
+            .where(sql `${lifecycleTransitionEvents.trigger} IN (${sql.join(triggers.map((t) => sql `${t}`), sql `, `)})`)
+            .get();
+        return result?.cnt ?? 0;
+    }
+    /* ═══════════════════ Internal ═══════════════════ */
+    #mapRow(row) {
+        return {
+            id: row.id,
+            recipeId: row.recipeId,
+            fromState: row.fromState,
+            toState: row.toState,
+            trigger: row.trigger,
+            operatorId: row.operatorId,
+            evidence: row.evidenceJson ? safeJsonParse(row.evidenceJson, null) : null,
+            proposalId: row.proposalId ?? null,
+            createdAt: row.createdAt,
+        };
+    }
+}
+/* ────────────────────── Util ────────────────────── */
+function safeJsonParse(json, fallback) {
+    if (!json) {
+        return fallback;
+    }
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return fallback;
+    }
+}