autosnippet 3.3.7 → 3.3.8

package/dist/lib/service/guard/ReverseGuard.js

@@ -39,11 +39,15 @@ const DRIFT_THRESHOLDS = {
 };
 /* ────────────────────── Class ────────────────────── */
 export class ReverseGuard {
-    #db;
+    #knowledgeRepo;
+    #entityRepo;
+    #sourceRefRepo;
     #signalBus;
     #logger = Logger.getInstance();
-    constructor(db, options = {}) {
-        this.#db = db;
+    constructor(knowledgeRepo, entityRepo, sourceRefRepo, options = {}) {
+        this.#knowledgeRepo = knowledgeRepo;
+        this.#entityRepo = entityRepo;
+        this.#sourceRefRepo = sourceRefRepo;
         this.#signalBus = options.signalBus ?? null;
     }
     /**
@@ -107,20 +111,12 @@ export class ReverseGuard {
     /* ── 内部方法 ── */
     #loadActiveRuleRecipes() {
         try {
-            const rows = this.#db
-                .prepare(`SELECT id, title,
-                json_extract(content, '$.coreCode') AS core_code,
-                json_extract(content, '$.pattern') AS guard_pattern,
-                stats
-         FROM knowledge_entries
-         WHERE lifecycle = 'active'
-           AND kind = 'rule'`)
-                .all();
+            const rows = this.#knowledgeRepo.findActiveRulesWithContentSync();
             return rows.map((r) => ({
                 id: r.id,
                 title: r.title,
-                core_code: r.core_code ?? null,
-                guard_pattern: r.guard_pattern ?? null,
+                core_code: r.coreCode ?? null,
+                guard_pattern: r.guardPattern ?? null,
                 stats: r.stats ?? null,
             }));
         }
@@ -139,10 +135,8 @@ export class ReverseGuard {
         const signals = [];
         for (const symbol of symbols) {
             try {
-                const row = this.#db
-                    .prepare(`SELECT name FROM code_entities WHERE name = ? LIMIT 1`)
-                    .get(symbol);
-                if (!row) {
+                const exists = this.#entityRepo.existsByName(symbol);
+                if (!exists) {
                     signals.push({
                         type: 'symbol_missing',
                         detail: `Symbol "${symbol}" referenced in recipe coreCode not found in codebase`,
@@ -212,26 +206,25 @@ export class ReverseGuard {
      */
     #checkSourceRefStaleness(recipeId) {
         try {
-            const rows = this.#db
-                .prepare(`SELECT source_path FROM recipe_source_refs WHERE recipe_id = ? AND status = 'stale'`)
-                .all(recipeId);
-            if (rows.length === 0) {
+            const staleRefs = this.#sourceRefRepo
+                .findByRecipeId(recipeId)
+                .filter((r) => r.status === 'stale');
+            if (staleRefs.length === 0) {
                 return [];
             }
             return [
                 {
                     type: 'source_ref_stale',
-                    detail: `${rows.length} source file(s) no longer exist: ${rows
+                    detail: `${staleRefs.length} source file(s) no longer exist: ${staleRefs
                         .slice(0, 3)
-                        .map((r) => r.source_path)
-                        .join(', ')}${rows.length > 3 ? ` (+${rows.length - 3} more)` : ''}`,
-                    severity: rows.length >= 3 ? 'high' : 'medium',
+                        .map((r) => r.sourcePath)
+                        .join(', ')}${staleRefs.length > 3 ? ` (+${staleRefs.length - 3} more)` : ''}`,
+                    severity: staleRefs.length >= 3 ? 'high' : 'medium',
                     evidence: {},
                 },
             ];
         }
         catch {
-            // recipe_source_refs 表可能不存在
             return [];
         }
     }
@@ -257,10 +250,7 @@ export class ReverseGuard {
     }
     #getHistoricalHits(recipeId) {
         try {
-            const row = this.#db
-                .prepare(`SELECT json_extract(stats, '$.guardHits') AS hits FROM knowledge_entries WHERE id = ?`)
-                .get(recipeId);
-            return row?.hits ?? 0;
+            return this.#knowledgeRepo.getGuardHitsSync(recipeId);
         }
         catch {
             return 0;

package/dist/lib/service/guard/ViolationsStore.d.ts

@@ -2,19 +2,15 @@
  * ViolationsStore — Guard 违反记录存储（DB 版）
  * 记录每次 as:audit 运行的审计结果，持久化到 SQLite guard_violations 表。
  * 最多保留 200 条。
+ *
+ * 所有操作使用 Drizzle 类型安全 API（零 raw SQL）。
  */
 import { type DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
-interface DatabaseLike {
-    prepare(sql: string): {
-        run(...params: unknown[]): unknown;
-        get(...params: unknown[]): Record<string, unknown>;
-        all(...params: unknown[]): Record<string, unknown>[];
-    };
-}
 interface ViolationRecord {
     ruleId?: string;
     severity?: string;
     message?: string;
+    line?: number;
     [key: string]: unknown;
 }
 interface RunInput {
@@ -32,27 +28,24 @@ interface RunOutput {
 }
 export declare class ViolationsStore {
     #private;
-    /** @param db SQLite 数据库实例 */
-    constructor(db: DatabaseLike, drizzle?: DrizzleDB);
+    /** @param _db 保留签名兼容 (不再使用) */
+    constructor(_db: unknown, drizzle?: DrizzleDB);
     /**
      * 追加一次 Guard 运行记录
      * ★ 去重：同一文件、同一违规集合不重复入库，仅更新时间戳
-     * ★ Drizzle 类型安全 INSERT + raw SQL 截断
+     * ★ 全 Drizzle 类型安全
      */
     appendRun(run: RunInput): string;
     /**
      * 获取所有运行记录（最新在后）
-     * ★ Drizzle 类型安全 SELECT
      */
     getRuns(): RunOutput[];
     /**
      * 按文件路径查询历史
-     * ★ Drizzle 类型安全 SELECT WHERE
      */
     getRunsByFile(filePath: string): RunOutput[];
     /**
      * 获取最近 N 条记录
-     * ★ Drizzle 类型安全 SELECT + ORDER + LIMIT
      */
     getRecentRuns(n?: number): RunOutput[];
     /** 获取统计汇总 */
@@ -65,12 +58,16 @@ export declare class ViolationsStore {
     /**
      * 按规则 ID 聚合统计
      * 利用 SQLite json_each 展开 violations_json 数组
-     * @returns >}
+     *
+     * json_each 是 SQLite 专有函数，Drizzle 无 typed API (ORM limitation)
      */
-    getStatsByRule(): Record<string, unknown>[];
+    getStatsByRule(): {
+        ruleId: string | null;
+        severity: string | null;
+        count: number;
+    }[];
     /**
      * 获取趋势数据 — 对比最近两次运行
-     * @returns }
      */
     getTrend(): {
         errorsChange: number;
@@ -81,10 +78,7 @@ export declare class ViolationsStore {
         previousWarnings: number;
         hasHistory: boolean;
     };
-    /**
-     * 清空所有记录
-     * ★ Drizzle 类型安全 DELETE
-     */
+    /** 清空所有记录 */
     clearRuns(): void;
     /** 清除指定规则或文件的记录 */
     clearAll(): Promise<void>;
@@ -92,7 +86,7 @@ export declare class ViolationsStore {
         ruleId?: string;
         file?: string;
     }): Promise<void>;
-    /** 兼容 v2 violations.js 路由的 list() */
+    /** 分页查询 */
     list(filters?: {
         file?: string;
     }, { page, limit }?: {

package/dist/lib/service/guard/ViolationsStore.js

@@ -2,24 +2,24 @@
  * ViolationsStore — Guard 违反记录存储（DB 版）
  * 记录每次 as:audit 运行的审计结果，持久化到 SQLite guard_violations 表。
  * 最多保留 200 条。
+ *
+ * 所有操作使用 Drizzle 类型安全 API（零 raw SQL）。
  */
-import { asc, desc, eq, sql } from 'drizzle-orm';
+import { asc, count, desc, eq, sql } from 'drizzle-orm';
 import { getDrizzle } from '../../infrastructure/database/drizzle/index.js';
 import { guardViolations } from '../../infrastructure/database/drizzle/schema.js';
 const MAX_RUNS = 200;
 export class ViolationsStore {
-    #db;
     #drizzle;
-    /** @param db SQLite 数据库实例 */
-    constructor(db, drizzle) {
-        this.#db = db;
+    /** @param _db 保留签名兼容 (不再使用) */
+    constructor(_db, drizzle) {
         this.#drizzle = drizzle ?? getDrizzle();
     }
     // ─── 写入 ─────────────────────────────────────────────
     /**
      * 追加一次 Guard 运行记录
      * ★ 去重：同一文件、同一违规集合不重复入库，仅更新时间戳
-     * ★ Drizzle 类型安全 INSERT + raw SQL 截断
+     * ★ 全 Drizzle 类型安全
      */
     appendRun(run) {
         const filePath = run.filePath || '';
@@ -28,16 +28,28 @@ export class ViolationsStore {
         // ── 去重：查最近一条同文件记录，比较违规指纹 ──
         const fingerprint = this.#violationFingerprint(violations);
         if (filePath) {
-            const lastRow = this.#db
-                .prepare(`SELECT id, violations_json FROM guard_violations WHERE file_path = ? ORDER BY created_at DESC LIMIT 1`)
-                .get(filePath);
+            const lastRow = this.#drizzle
+                .select({
+                id: guardViolations.id,
+                violationsJson: guardViolations.violationsJson,
+            })
+                .from(guardViolations)
+                .where(eq(guardViolations.filePath, filePath))
+                .orderBy(desc(guardViolations.createdAt))
+                .limit(1)
+                .get();
             if (lastRow) {
-                const lastFingerprint = this.#violationFingerprint(JSON.parse(lastRow.violations_json || '[]'));
+                const lastFingerprint = this.#violationFingerprint(JSON.parse(lastRow.violationsJson || '[]'));
                 if (fingerprint === lastFingerprint) {
                     // 违规未变化：仅刷新时间戳，不新增行
-                    this.#db
-                        .prepare(`UPDATE guard_violations SET triggered_at = ?, created_at = ? WHERE id = ?`)
-                        .run(new Date().toISOString(), Math.floor(Date.now() / 1000), lastRow.id);
+                    this.#drizzle
+                        .update(guardViolations)
+                        .set({
+                        triggeredAt: new Date().toISOString(),
+                        createdAt: Math.floor(Date.now() / 1000),
+                    })
+                        .where(eq(guardViolations.id, lastRow.id))
+                        .run();
                     return lastRow.id;
                 }
             }
@@ -56,14 +68,15 @@ export class ViolationsStore {
             createdAt: now,
         })
             .run();
-        // 超限截断：保留最新 MAX_RUNS 条（子查询保留 raw SQL）
-        this.#db
-            .prepare(`
-      DELETE FROM guard_violations WHERE id NOT IN (
-        SELECT id FROM guard_violations ORDER BY created_at DESC LIMIT ?
-      )
-    `)
-            .run(MAX_RUNS);
+        // 超限截断：保留最新 MAX_RUNS 条
+        this.#drizzle
+            .delete(guardViolations)
+            .where(sql `${guardViolations.id} NOT IN (
+          SELECT ${guardViolations.id} FROM ${guardViolations}
+          ORDER BY ${guardViolations.createdAt} DESC
+          LIMIT ${MAX_RUNS}
+        )`)
+            .run();
         return id;
     }
     /**
@@ -78,7 +91,6 @@ export class ViolationsStore {
     // ─── 查询 ─────────────────────────────────────────────
     /**
      * 获取所有运行记录（最新在后）
-     * ★ Drizzle 类型安全 SELECT
      */
     getRuns() {
         const rows = this.#drizzle
@@ -90,7 +102,6 @@ export class ViolationsStore {
     }
     /**
      * 按文件路径查询历史
-     * ★ Drizzle 类型安全 SELECT WHERE
      */
     getRunsByFile(filePath) {
         const rows = this.#drizzle
@@ -103,7 +114,6 @@ export class ViolationsStore {
     }
     /**
      * 获取最近 N 条记录
-     * ★ Drizzle 类型安全 SELECT + ORDER + LIMIT
      */
     getRecentRuns(n = 20) {
         const rows = this.#drizzle
@@ -116,41 +126,41 @@ export class ViolationsStore {
     }
     /** 获取统计汇总 */
     getStats() {
-        const row = this.#db
-            .prepare(`
-      SELECT
-        COUNT(*)                 AS totalRuns,
-        COALESCE(SUM(violation_count), 0) AS totalViolations,
-        MAX(triggered_at)        AS lastRunAt
-      FROM guard_violations
-    `)
-            .get();
+        const [row] = this.#drizzle
+            .select({
+            totalRuns: count(),
+            totalViolations: sql `COALESCE(SUM(${guardViolations.violationCount}), 0)`,
+            lastRunAt: sql `MAX(${guardViolations.triggeredAt})`,
+        })
+            .from(guardViolations)
+            .all();
+        const totalRuns = row?.totalRuns ?? 0;
+        const totalViolations = row?.totalViolations ?? 0;
         return {
-            totalRuns: row.totalRuns,
-            totalViolations: row.totalViolations,
-            averageViolationsPerRun: row.totalRuns > 0 ? (row.totalViolations / row.totalRuns).toFixed(2) : 0,
-            lastRunAt: row.lastRunAt || null,
+            totalRuns,
+            totalViolations,
+            averageViolationsPerRun: totalRuns > 0 ? (totalViolations / totalRuns).toFixed(2) : 0,
+            lastRunAt: row?.lastRunAt || null,
         };
     }
     /**
      * 按规则 ID 聚合统计
      * 利用 SQLite json_each 展开 violations_json 数组
-     * @returns >}
+     *
+     * json_each 是 SQLite 专有函数，Drizzle 无 typed API (ORM limitation)
      */
     getStatsByRule() {
         try {
-            return this.#db
-                .prepare(`
+            return this.#drizzle.all(sql `
         SELECT
           json_extract(j.value, '$.ruleId') AS ruleId,
           json_extract(j.value, '$.severity') AS severity,
           COUNT(*) AS count
-        FROM guard_violations gv, json_each(gv.violations_json) j
+        FROM ${guardViolations} gv, json_each(gv.violations_json) j
         WHERE json_extract(j.value, '$.ruleId') IS NOT NULL
         GROUP BY ruleId, severity
         ORDER BY count DESC
-      `)
-                .all();
+      `);
         }
         catch {
             return [];
@@ -158,7 +168,6 @@ export class ViolationsStore {
     }
     /**
      * 获取趋势数据 — 对比最近两次运行
-     * @returns }
      */
     getTrend() {
         const recent = this.getRecentRuns(2);
@@ -190,10 +199,7 @@ export class ViolationsStore {
         };
     }
     // ─── 清除 ─────────────────────────────────────────────
-    /**
-     * 清空所有记录
-     * ★ Drizzle 类型安全 DELETE
-     */
+    /** 清空所有记录 */
     clearRuns() {
         this.#drizzle.delete(guardViolations).run();
     }
@@ -209,38 +215,38 @@ export class ViolationsStore {
             this.clearRuns();
         }
     }
-    /** 兼容 v2 violations.js 路由的 list() */
+    /** 分页查询 */
     async list(filters = {}, { page = 1, limit = 20 } = {}) {
         const offset = (page - 1) * limit;
-        let sql = 'SELECT * FROM guard_violations';
-        const params = [];
-        if (filters.file) {
-            sql += ' WHERE file_path = ?';
-            params.push(filters.file);
-        }
-        sql += ' ORDER BY created_at DESC LIMIT ? OFFSET ?';
-        params.push(limit, offset);
-        const rows = this.#db.prepare(sql).all(...params);
-        const countSql = filters.file
-            ? 'SELECT COUNT(*) AS c FROM guard_violations WHERE file_path = ?'
-            : 'SELECT COUNT(*) AS c FROM guard_violations';
-        const countParams = filters.file ? [filters.file] : [];
-        const total = this.#db.prepare(countSql).get(...countParams).c;
+        const condition = filters.file ? eq(guardViolations.filePath, filters.file) : undefined;
+        const rows = this.#drizzle
+            .select()
+            .from(guardViolations)
+            .where(condition)
+            .orderBy(desc(guardViolations.createdAt))
+            .limit(limit)
+            .offset(offset)
+            .all();
+        const [totalRow] = this.#drizzle
+            .select({ c: count() })
+            .from(guardViolations)
+            .where(condition)
+            .all();
+        const total = totalRow?.c ?? 0;
         return {
             data: rows.map((r) => this.#rowToRun(r)),
             pagination: { page, limit, total, pages: Math.ceil(total / limit) },
         };
     }
     // ─── 内部 ─────────────────────────────────────────────
-    /** 行转运行记录（兼容 raw SQL snake_case 和 Drizzle camelCase） */
+    /** Drizzle camelCase 行 → RunOutput */
     #rowToRun(row) {
-        const violationsRaw = (row.violationsJson ?? row.violations_json);
         return {
             id: row.id,
-            filePath: (row.filePath ?? row.file_path),
-            triggeredAt: (row.triggeredAt ?? row.triggered_at),
-            violations: violationsRaw ? JSON.parse(violationsRaw) : [],
-            violationCount: (row.violationCount ?? row.violation_count),
+            filePath: row.filePath,
+            triggeredAt: row.triggeredAt,
+            violations: row.violationsJson ? JSON.parse(row.violationsJson) : [],
+            violationCount: row.violationCount ?? 0,
             summary: row.summary || '',
         };
     }