autosnippet 3.3.7 → 3.3.8

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

@@ -1,5 +1,5 @@
 /**
- * ProposalRepository — evolution_proposals 表 CRUD
+ * ProposalRepository — evolution_proposals 表 CRUD (Drizzle ORM)
  *
  * 操作 evolution_proposals 表，存储进化提案（merge/supersede/enhance/deprecate/
  * reorganize/contradiction/correction）。
@@ -8,8 +8,14 @@
  *   - 去重：同 target + 同 type 不允许多个 observing 状态的 Proposal
  *   - Rate Limit：同一 target 不允许同时存在多个相同类型的 observing Proposal
  *   - JSON 字段（evidence/related_recipe_ids）序列化/反序列化
+ *
+ * Drizzle 迁移策略 (Phase 5a)：
+ *   - 全部 raw SQL → Drizzle 类型安全 API
+ *   - 构造器接收 DrizzleDB（不再需要 raw Database）
  */
 import { randomBytes } from 'node:crypto';
+import { and, count, desc, eq, inArray, lte } from 'drizzle-orm';
+import { evolutionProposals } from '../../infrastructure/database/drizzle/schema.js';
 /* ────────────────────── Constants ────────────────────── */
 /** 默认观察窗口：7 天 */
 const DEFAULT_OBSERVATION_WINDOW = 7 * 24 * 60 * 60 * 1000;
@@ -35,9 +41,9 @@ const AUTO_OBSERVE_THRESHOLDS = {
 };
 /* ────────────────────── Class ────────────────────── */
 export class ProposalRepository {
-    #db;
-    constructor(db) {
-        this.#db = db;
+    #drizzle;
+    constructor(drizzle) {
+        this.#drizzle = drizzle;
     }
     /* ═══════════════════ Create ═══════════════════ */
     /**
@@ -73,55 +79,66 @@ export class ProposalRepository {
             resolvedBy: null,
             resolution: null,
         };
-        this.#db
-            .prepare(`INSERT INTO evolution_proposals
-         (id, type, target_recipe_id, related_recipe_ids, confidence, source, description, evidence, status, proposed_at, expires_at)
-         VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
-            .run(record.id, record.type, record.targetRecipeId, JSON.stringify(record.relatedRecipeIds), record.confidence, record.source, record.description, JSON.stringify(record.evidence), record.status, record.proposedAt, record.expiresAt);
+        this.#drizzle
+            .insert(evolutionProposals)
+            .values({
+            id: record.id,
+            type: record.type,
+            targetRecipeId: record.targetRecipeId,
+            relatedRecipeIds: JSON.stringify(record.relatedRecipeIds),
+            confidence: record.confidence,
+            source: record.source,
+            description: record.description,
+            evidence: JSON.stringify(record.evidence),
+            status: record.status,
+            proposedAt: record.proposedAt,
+            expiresAt: record.expiresAt,
+        })
+            .run();
         return record;
     }
     /* ═══════════════════ Read ═══════════════════ */
     /** 按 ID 查询 */
     findById(id) {
-        const row = this.#db.prepare(`SELECT * FROM evolution_proposals WHERE id = ?`).get(id);
+        const row = this.#drizzle
+            .select()
+            .from(evolutionProposals)
+            .where(eq(evolutionProposals.id, id))
+            .limit(1)
+            .get();
         return row ? ProposalRepository.#mapRow(row) : null;
     }
     /** 按条件查询 */
     find(filter = {}) {
         const conditions = [];
-        const params = [];
         if (filter.status) {
             if (Array.isArray(filter.status)) {
-                const placeholders = filter.status.map(() => '?').join(', ');
-                conditions.push(`status IN (${placeholders})`);
-                params.push(...filter.status);
+                conditions.push(inArray(evolutionProposals.status, filter.status));
             }
             else {
-                conditions.push('status = ?');
-                params.push(filter.status);
+                conditions.push(eq(evolutionProposals.status, filter.status));
             }
         }
         if (filter.type) {
-            conditions.push('type = ?');
-            params.push(filter.type);
+            conditions.push(eq(evolutionProposals.type, filter.type));
         }
         if (filter.targetRecipeId) {
-            conditions.push('target_recipe_id = ?');
-            params.push(filter.targetRecipeId);
+            conditions.push(eq(evolutionProposals.targetRecipeId, filter.targetRecipeId));
         }
         if (filter.source) {
-            conditions.push('source = ?');
-            params.push(filter.source);
+            conditions.push(eq(evolutionProposals.source, filter.source));
         }
         if (filter.expiredBefore) {
-            conditions.push('expires_at <= ?');
-            params.push(filter.expiredBefore);
+            conditions.push(lte(evolutionProposals.expiresAt, filter.expiredBefore));
         }
-        const where = conditions.length > 0 ? `WHERE ${conditions.join(' AND ')}` : '';
-        const rows = this.#db
-            .prepare(`SELECT * FROM evolution_proposals ${where} ORDER BY proposed_at DESC`)
-            .all(...params);
-        return rows.map(ProposalRepository.#mapRow);
+        const condition = conditions.length > 0 ? and(...conditions) : undefined;
+        const rows = this.#drizzle
+            .select()
+            .from(evolutionProposals)
+            .where(condition)
+            .orderBy(desc(evolutionProposals.proposedAt))
+            .all();
+        return rows.map((r) => ProposalRepository.#mapRow(r));
     }
     /** 查询已到期的 observing 状态 Proposal */
     findExpiredObserving() {
@@ -152,44 +169,81 @@ export class ProposalRepository {
             return false;
         }
         const expiresAt = now + (OBSERVATION_WINDOWS[proposal.type] ?? DEFAULT_OBSERVATION_WINDOW);
-        const result = this.#db
-            .prepare(`UPDATE evolution_proposals SET status = 'observing', expires_at = ? WHERE id = ? AND status = 'pending'`)
-            .run(expiresAt, id);
+        const result = this.#drizzle
+            .update(evolutionProposals)
+            .set({ status: 'observing', expiresAt })
+            .where(and(eq(evolutionProposals.id, id), eq(evolutionProposals.status, 'pending')))
+            .run();
         return result.changes > 0;
     }
     /** 标记 Proposal 为已执行 */
     markExecuted(id, resolution, resolvedBy = 'auto') {
-        const result = this.#db
-            .prepare(`UPDATE evolution_proposals SET status = 'executed', resolved_at = ?, resolved_by = ?, resolution = ? WHERE id = ? AND status = 'observing'`)
-            .run(Date.now(), resolvedBy, resolution, id);
+        const result = this.#drizzle
+            .update(evolutionProposals)
+            .set({
+            status: 'executed',
+            resolvedAt: Date.now(),
+            resolvedBy,
+            resolution,
+        })
+            .where(and(eq(evolutionProposals.id, id), eq(evolutionProposals.status, 'observing')))
+            .run();
         return result.changes > 0;
     }
     /** 标记 Proposal 为已拒绝 */
     markRejected(id, resolution, resolvedBy = 'auto') {
-        const result = this.#db
-            .prepare(`UPDATE evolution_proposals SET status = 'rejected', resolved_at = ?, resolved_by = ?, resolution = ? WHERE id = ? AND status IN ('pending', 'observing')`)
-            .run(Date.now(), resolvedBy, resolution, id);
+        const result = this.#drizzle
+            .update(evolutionProposals)
+            .set({
+            status: 'rejected',
+            resolvedAt: Date.now(),
+            resolvedBy,
+            resolution,
+        })
+            .where(and(eq(evolutionProposals.id, id), inArray(evolutionProposals.status, ['pending', 'observing'])))
+            .run();
         return result.changes > 0;
     }
     /** 标记 Proposal 为过期 */
     markExpired(id) {
-        const result = this.#db
-            .prepare(`UPDATE evolution_proposals SET status = 'expired', resolved_at = ? WHERE id = ? AND status IN ('pending', 'observing')`)
-            .run(Date.now(), id);
+        const result = this.#drizzle
+            .update(evolutionProposals)
+            .set({
+            status: 'expired',
+            resolvedAt: Date.now(),
+        })
+            .where(and(eq(evolutionProposals.id, id), inArray(evolutionProposals.status, ['pending', 'observing'])))
+            .run();
         return result.changes > 0;
     }
     /** 更新 evidence（用于追加观察期指标快照） */
     updateEvidence(id, evidence) {
-        const result = this.#db
-            .prepare(`UPDATE evolution_proposals SET evidence = ? WHERE id = ?`)
-            .run(JSON.stringify(evidence), id);
+        const result = this.#drizzle
+            .update(evolutionProposals)
+            .set({ evidence: JSON.stringify(evidence) })
+            .where(eq(evolutionProposals.id, id))
+            .run();
         return result.changes > 0;
     }
+    /* ═══════════════════ Delete ═══════════════════ */
+    /** 按 target Recipe ID 删除所有 Proposal（用于知识删除时清理关联提案） */
+    deleteByTargetRecipeId(targetRecipeId) {
+        const result = this.#drizzle
+            .delete(evolutionProposals)
+            .where(eq(evolutionProposals.targetRecipeId, targetRecipeId))
+            .run();
+        return result.changes;
+    }
     /* ═══════════════════ Stats ═══════════════════ */
     /** 统计各状态的 Proposal 数量 */
     stats() {
-        const rows = this.#db
-            .prepare(`SELECT status, COUNT(*) as count FROM evolution_proposals GROUP BY status`)
+        const rows = this.#drizzle
+            .select({
+            status: evolutionProposals.status,
+            count: count(),
+        })
+            .from(evolutionProposals)
+            .groupBy(evolutionProposals.status)
             .all();
         const result = {
             pending: 0,
@@ -206,9 +260,12 @@ export class ProposalRepository {
     /* ═══════════════════ Private ═══════════════════ */
     /** 去重检查：同 target + 同 type 是否已有 pending/observing Proposal */
     #hasDuplicate(targetRecipeId, type) {
-        const row = this.#db
-            .prepare(`SELECT 1 FROM evolution_proposals WHERE target_recipe_id = ? AND type = ? AND status IN ('pending', 'observing') LIMIT 1`)
-            .get(targetRecipeId, type);
+        const row = this.#drizzle
+            .select({ id: evolutionProposals.id })
+            .from(evolutionProposals)
+            .where(and(eq(evolutionProposals.targetRecipeId, targetRecipeId), eq(evolutionProposals.type, type), inArray(evolutionProposals.status, ['pending', 'observing'])))
+            .limit(1)
+            .get();
         return row !== undefined;
     }
     /** 根据 type + confidence 判断初始状态 */
@@ -221,22 +278,22 @@ export class ProposalRepository {
         const rand = randomBytes(4).toString('hex');
         return `ep-${timestamp}-${rand}`;
     }
-    /** DB 行 → ProposalRecord */
+    /** Drizzle Row → ProposalRecord */
     static #mapRow(row) {
         return {
             id: row.id,
             type: row.type,
-            targetRecipeId: row.target_recipe_id,
-            relatedRecipeIds: safeJsonParse(row.related_recipe_ids, []),
+            targetRecipeId: row.targetRecipeId,
+            relatedRecipeIds: safeJsonParse(row.relatedRecipeIds, []),
             confidence: row.confidence,
             source: row.source,
-            description: row.description,
+            description: row.description ?? '',
             evidence: safeJsonParse(row.evidence, []),
             status: row.status,
-            proposedAt: row.proposed_at,
-            expiresAt: row.expires_at,
-            resolvedAt: row.resolved_at ?? null,
-            resolvedBy: row.resolved_by ?? null,
+            proposedAt: row.proposedAt,
+            expiresAt: row.expiresAt,
+            resolvedAt: row.resolvedAt ?? null,
+            resolvedBy: row.resolvedBy ?? null,
             resolution: row.resolution ?? null,
         };
     }

package/dist/lib/repository/guard/GuardViolationRepository.d.ts

@@ -0,0 +1,104 @@
+/**
+ * GuardViolationRepository — Guard 违反记录的仓储实现
+ *
+ * 从 ViolationsStore 提取的数据操作，
+ * 使用 Drizzle 类型安全 API 操作 guard_violations 表。
+ */
+import { guardViolations } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+export interface ViolationRecord {
+    ruleId?: string;
+    severity?: string;
+    message?: string;
+    line?: number;
+    [key: string]: unknown;
+}
+export interface GuardViolationEntity {
+    id: string;
+    filePath: string;
+    triggeredAt: string;
+    violationCount: number;
+    summary: string;
+    violations: ViolationRecord[];
+    createdAt: number;
+}
+export interface GuardViolationInsert {
+    id: string;
+    filePath: string;
+    triggeredAt: string;
+    violationCount: number;
+    summary?: string;
+    violations: ViolationRecord[];
+    createdAt: number;
+}
+export interface ViolationStats {
+    totalRuns: number;
+    totalViolations: number;
+    averageViolationsPerRun: string | number;
+    lastRunAt: string | null;
+}
+export interface ViolationStatByRule {
+    ruleId: string | null;
+    severity: string | null;
+    count: number;
+}
+export interface PaginatedViolations {
+    data: GuardViolationEntity[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+}
+export declare class GuardViolationRepositoryImpl extends RepositoryBase<typeof guardViolations, GuardViolationEntity> {
+    #private;
+    /** 最大保留条数 */
+    static readonly MAX_RUNS = 200;
+    constructor(drizzle: ConstructorParameters<typeof RepositoryBase<typeof guardViolations, GuardViolationEntity>>[0]);
+    findById(id: string): Promise<GuardViolationEntity | null>;
+    create(data: GuardViolationInsert): Promise<GuardViolationEntity>;
+    delete(id: string): Promise<boolean>;
+    /** 获取指定文件的最近一条记录 (用于去重比较) */
+    getLastByFile(filePath: string): Promise<{
+        id: string;
+        violationsJson: string;
+    } | null>;
+    /** 刷新已有记录的时间戳 (去重命中时) */
+    refreshTimestamp(id: string): Promise<void>;
+    /** 获取所有运行记录 (最旧在前) */
+    getRuns(): Promise<GuardViolationEntity[]>;
+    /** 按文件路径查询 */
+    getRunsByFile(filePath: string): Promise<GuardViolationEntity[]>;
+    /** 获取最近 N 条记录 */
+    getRecentRuns(n?: number): Promise<GuardViolationEntity[]>;
+    /** 分页查询 */
+    list(filters?: {
+        file?: string;
+    }, options?: {
+        page?: number;
+        limit?: number;
+    }): Promise<PaginatedViolations>;
+    /** 获取统计汇总 */
+    getStats(): Promise<ViolationStats>;
+    /**
+     * 按规则 ID 聚合统计
+     * 利用 SQLite json_each 展开 violations_json 数组
+     *
+     * json_each 是 SQLite 专有函数，Drizzle 无 typed API (ORM limitation)
+     */
+    getStatsByRule(): Promise<ViolationStatByRule[]>;
+    /** 截断超限记录，保留最新 maxRuns 条 */
+    enforceCapacity(maxRuns?: number): Promise<number>;
+    /** 清空所有记录 */
+    clearAll(): Promise<void>;
+    /** 清除指定文件的记录 */
+    clearByFile(filePath: string): Promise<number>;
+    /**
+     * 最近的 violation JSON 列表 (CoverageAnalyzer.#getRecentViolations)
+     */
+    findRecentViolationsJson(limit: number): Array<{
+        filePath: string;
+        violationsJson: string;
+    }>;
+}

package/dist/lib/repository/guard/GuardViolationRepository.js

@@ -0,0 +1,217 @@
+/**
+ * GuardViolationRepository — Guard 违反记录的仓储实现
+ *
+ * 从 ViolationsStore 提取的数据操作，
+ * 使用 Drizzle 类型安全 API 操作 guard_violations 表。
+ */
+import { asc, count, desc, eq, sql } from 'drizzle-orm';
+import { guardViolations } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+/* ═══ Repository 实现 ═══ */
+export class GuardViolationRepositoryImpl extends RepositoryBase {
+    /** 最大保留条数 */
+    static MAX_RUNS = 200;
+    constructor(drizzle) {
+        super(drizzle, guardViolations);
+    }
+    /* ─── CRUD ─── */
+    async findById(id) {
+        const row = this.drizzle.select().from(this.table).where(eq(this.table.id, id)).limit(1).get();
+        return row ? this.#mapRow(row) : null;
+    }
+    async create(data) {
+        this.drizzle
+            .insert(this.table)
+            .values({
+            id: data.id,
+            filePath: data.filePath,
+            triggeredAt: data.triggeredAt,
+            violationCount: data.violationCount,
+            summary: data.summary ?? '',
+            violationsJson: JSON.stringify(data.violations),
+            createdAt: data.createdAt,
+        })
+            .run();
+        return (await this.findById(data.id));
+    }
+    async delete(id) {
+        const result = this.drizzle.delete(this.table).where(eq(this.table.id, id)).run();
+        return result.changes > 0;
+    }
+    /* ─── 去重查询 ─── */
+    /** 获取指定文件的最近一条记录 (用于去重比较) */
+    async getLastByFile(filePath) {
+        const row = this.drizzle
+            .select({
+            id: this.table.id,
+            violationsJson: this.table.violationsJson,
+        })
+            .from(this.table)
+            .where(eq(this.table.filePath, filePath))
+            .orderBy(desc(this.table.createdAt))
+            .limit(1)
+            .get();
+        return row ? { id: row.id, violationsJson: row.violationsJson ?? '[]' } : null;
+    }
+    /** 刷新已有记录的时间戳 (去重命中时) */
+    async refreshTimestamp(id) {
+        this.drizzle
+            .update(this.table)
+            .set({
+            triggeredAt: new Date().toISOString(),
+            createdAt: Math.floor(Date.now() / 1000),
+        })
+            .where(eq(this.table.id, id))
+            .run();
+    }
+    /* ─── 查询 ─── */
+    /** 获取所有运行记录 (最旧在前) */
+    async getRuns() {
+        const rows = this.drizzle.select().from(this.table).orderBy(asc(this.table.createdAt)).all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 按文件路径查询 */
+    async getRunsByFile(filePath) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(eq(this.table.filePath, filePath))
+            .orderBy(asc(this.table.createdAt))
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 获取最近 N 条记录 */
+    async getRecentRuns(n = 20) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .orderBy(desc(this.table.createdAt), sql `rowid DESC`)
+            .limit(n)
+            .all();
+        return rows.reverse().map((r) => this.#mapRow(r));
+    }
+    /** 分页查询 */
+    async list(filters = {}, options = {}) {
+        const { page = 1, limit = 20 } = options;
+        const offset = (page - 1) * limit;
+        const condition = filters.file ? eq(this.table.filePath, filters.file) : undefined;
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(condition)
+            .orderBy(desc(this.table.createdAt))
+            .limit(limit)
+            .offset(offset)
+            .all();
+        const [totalRow] = this.drizzle
+            .select({ cnt: count() })
+            .from(this.table)
+            .where(condition)
+            .all();
+        const total = totalRow?.cnt ?? 0;
+        return {
+            data: rows.map((r) => this.#mapRow(r)),
+            pagination: { page, limit, total, pages: Math.ceil(total / limit) },
+        };
+    }
+    /* ─── 统计 ─── */
+    /** 获取统计汇总 */
+    async getStats() {
+        const [row] = this.drizzle
+            .select({
+            totalRuns: count(),
+            totalViolations: sql `COALESCE(SUM(${this.table.violationCount}), 0)`,
+            lastRunAt: sql `MAX(${this.table.triggeredAt})`,
+        })
+            .from(this.table)
+            .all();
+        const totalRuns = row?.totalRuns ?? 0;
+        const totalViolations = row?.totalViolations ?? 0;
+        return {
+            totalRuns,
+            totalViolations,
+            averageViolationsPerRun: totalRuns > 0 ? (totalViolations / totalRuns).toFixed(2) : 0,
+            lastRunAt: row?.lastRunAt ?? null,
+        };
+    }
+    /**
+     * 按规则 ID 聚合统计
+     * 利用 SQLite json_each 展开 violations_json 数组
+     *
+     * json_each 是 SQLite 专有函数，Drizzle 无 typed API (ORM limitation)
+     */
+    async getStatsByRule() {
+        try {
+            const rows = this.drizzle.all(sql `
+        SELECT
+          json_extract(j.value, '$.ruleId') AS ruleId,
+          json_extract(j.value, '$.severity') AS severity,
+          COUNT(*) AS count
+        FROM ${this.table} gv, json_each(gv.violations_json) j
+        WHERE json_extract(j.value, '$.ruleId') IS NOT NULL
+        GROUP BY ruleId, severity
+        ORDER BY count DESC
+      `);
+            return rows;
+        }
+        catch {
+            return [];
+        }
+    }
+    /* ─── 容量控制 ─── */
+    /** 截断超限记录，保留最新 maxRuns 条 */
+    async enforceCapacity(maxRuns = GuardViolationRepositoryImpl.MAX_RUNS) {
+        const result = this.drizzle
+            .delete(this.table)
+            .where(sql `${this.table.id} NOT IN (
+          SELECT ${this.table.id} FROM ${this.table}
+          ORDER BY ${this.table.createdAt} DESC
+          LIMIT ${maxRuns}
+        )`)
+            .run();
+        return result.changes;
+    }
+    /** 清空所有记录 */
+    async clearAll() {
+        this.drizzle.delete(this.table).run();
+    }
+    /** 清除指定文件的记录 */
+    async clearByFile(filePath) {
+        const result = this.drizzle.delete(this.table).where(eq(this.table.filePath, filePath)).run();
+        return result.changes;
+    }
+    /**
+     * 最近的 violation JSON 列表 (CoverageAnalyzer.#getRecentViolations)
+     */
+    findRecentViolationsJson(limit) {
+        return this.drizzle
+            .select({
+            filePath: this.table.filePath,
+            violationsJson: this.table.violationsJson,
+        })
+            .from(this.table)
+            .orderBy(desc(this.table.createdAt))
+            .limit(limit)
+            .all();
+    }
+    /* ─── 内部辅助 ─── */
+    #mapRow(row) {
+        return {
+            id: row.id,
+            filePath: row.filePath,
+            triggeredAt: row.triggeredAt,
+            violationCount: row.violationCount ?? 0,
+            summary: row.summary ?? '',
+            violations: safeParseJSON(row.violationsJson, []),
+            createdAt: row.createdAt,
+        };
+    }
+}
+function safeParseJSON(str, fallback) {
+    try {
+        return str ? JSON.parse(str) : fallback;
+    }
+    catch {
+        return fallback;
+    }
+}