autosnippet 3.3.6 → 3.3.8

package/dist/lib/repository/audit/AuditRepository.js

@@ -0,0 +1,272 @@
+/**
+ * AuditRepository — 审计日志的仓储实现
+ *
+ * 从 AuditStore 提取的数据操作，
+ * 使用 Drizzle 类型安全 API 操作 audit_logs 表。
+ */
+import { and, avg, count, desc, eq, gt, gte, like, lte, sql } from 'drizzle-orm';
+import { auditLogs } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+/* ═══ Repository 实现 ═══ */
+export class AuditRepositoryImpl extends RepositoryBase {
+    constructor(drizzle) {
+        super(drizzle, auditLogs);
+    }
+    /* ─── 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,
+            timestamp: data.timestamp,
+            actor: data.actor,
+            actorContext: data.actorContext ?? '{}',
+            action: data.action,
+            resource: data.resource ?? null,
+            operationData: data.operationData ?? '{}',
+            result: data.result,
+            errorMessage: data.errorMessage ?? null,
+            duration: data.duration ?? null,
+        })
+            .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 query(filters = {}) {
+        const conditions = [];
+        if (filters.actor) {
+            conditions.push(eq(this.table.actor, filters.actor));
+        }
+        if (filters.action) {
+            conditions.push(eq(this.table.action, filters.action));
+        }
+        if (filters.result) {
+            conditions.push(eq(this.table.result, filters.result));
+        }
+        if (filters.startDate) {
+            conditions.push(gte(this.table.timestamp, filters.startDate));
+        }
+        if (filters.endDate) {
+            conditions.push(lte(this.table.timestamp, filters.endDate));
+        }
+        const condition = conditions.length > 0 ? and(...conditions) : undefined;
+        let query = this.drizzle
+            .select()
+            .from(this.table)
+            .where(condition)
+            .orderBy(desc(this.table.timestamp));
+        if (filters.limit) {
+            query = query.limit(filters.limit);
+        }
+        return query.all().map((r) => this.#mapRow(r));
+    }
+    /** 根据请求 ID 查询 */
+    async findByRequestId(requestId) {
+        return this.findById(requestId);
+    }
+    /** 根据角色查询 */
+    async findByActor(actor, limit = 100) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(eq(this.table.actor, actor))
+            .orderBy(desc(this.table.timestamp))
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 根据操作查询 */
+    async findByAction(action, limit = 100) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(eq(this.table.action, action))
+            .orderBy(desc(this.table.timestamp))
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /** 根据结果查询 */
+    async findByResult(result, limit = 100) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(eq(this.table.result, result))
+            .orderBy(desc(this.table.timestamp))
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /* ─── 统计 ─── */
+    /** 获取统计数据 */
+    async getStats(timeRange = '24h') {
+        const hours = timeRange === '24h' ? 24 : timeRange === '7d' ? 168 : 720; // 30d
+        const startTime = Date.now() - hours * 60 * 60 * 1000;
+        const startCondition = gte(this.table.timestamp, startTime);
+        // 总数
+        const [totalRow] = this.drizzle
+            .select({ cnt: count() })
+            .from(this.table)
+            .where(startCondition)
+            .all();
+        const total = totalRow?.cnt ?? 0;
+        // 成功数
+        const [successRow] = this.drizzle
+            .select({ cnt: count() })
+            .from(this.table)
+            .where(and(startCondition, eq(this.table.result, 'success')))
+            .all();
+        const success = successRow?.cnt ?? 0;
+        // 失败数
+        const [failureRow] = this.drizzle
+            .select({ cnt: count() })
+            .from(this.table)
+            .where(and(startCondition, eq(this.table.result, 'failure')))
+            .all();
+        const failure = failureRow?.cnt ?? 0;
+        // 按角色统计
+        const byActor = this.drizzle
+            .select({
+            actor: this.table.actor,
+            count: count(),
+        })
+            .from(this.table)
+            .where(startCondition)
+            .groupBy(this.table.actor)
+            .orderBy(desc(count()))
+            .all();
+        // 按操作统计
+        const byAction = this.drizzle
+            .select({
+            action: this.table.action,
+            count: count(),
+        })
+            .from(this.table)
+            .where(startCondition)
+            .groupBy(this.table.action)
+            .orderBy(desc(count()))
+            .all();
+        // 平均响应时间
+        const [avgRow] = this.drizzle
+            .select({
+            avgDuration: avg(this.table.duration),
+        })
+            .from(this.table)
+            .where(and(startCondition, sql `${this.table.duration} IS NOT NULL`))
+            .all();
+        const avgDuration = avgRow?.avgDuration ? `${Math.round(Number(avgRow.avgDuration))}ms` : 'N/A';
+        return {
+            timeRange,
+            total,
+            success,
+            failure,
+            successRate: total > 0 ? `${((success / total) * 100).toFixed(2)}%` : '0%',
+            avgDuration,
+            byActor,
+            byAction,
+        };
+    }
+    /* ─── 清理 ─── */
+    /**
+     * 清理过期审计日志
+     * @param maxAgeDays 保留天数
+     */
+    async cleanup(maxAgeDays = 90) {
+        try {
+            const cutoff = Date.now() - maxAgeDays * 86400000;
+            const result = this.drizzle
+                .delete(this.table)
+                .where(sql `${this.table.timestamp} < ${cutoff}`)
+                .run();
+            return { deleted: result.changes ?? 0 };
+        }
+        catch {
+            return { deleted: 0 };
+        }
+    }
+    /**
+     * Guard 违规规则名 TOP-N (SkillAdvisor.#getGuardPatterns)
+     */
+    async findTopGuardViolationRules(minCount, limit) {
+        return this.drizzle
+            .select({
+            ruleName: sql `json_extract(${this.table.operationData}, '$.ruleName')`.as('ruleName'),
+            cnt: count(),
+        })
+            .from(this.table)
+            .where(and(like(this.table.action, 'guard%'), eq(this.table.result, 'violation')))
+            .groupBy(sql `json_extract(${this.table.operationData}, '$.ruleName')`)
+            .having(sql `count(*) >= ${minCount}`)
+            .orderBy(desc(count()))
+            .limit(limit)
+            .all();
+    }
+    /**
+     * Guard 违规信号 (SignalCollector.#collectGuardSignals)
+     */
+    async findGuardViolationSignals(limit) {
+        return this.drizzle
+            .select({
+            ruleName: sql `json_extract(${this.table.operationData}, '$.ruleName')`.as('ruleName'),
+            cnt: count(),
+            lastAt: sql `MAX(${this.table.timestamp})`.as('lastAt'),
+        })
+            .from(this.table)
+            .where(and(like(this.table.action, 'guard%'), eq(this.table.result, 'violation')))
+            .groupBy(sql `json_extract(${this.table.operationData}, '$.ruleName')`)
+            .having(sql `count(*) > 0`)
+            .orderBy(desc(count()))
+            .limit(limit)
+            .all();
+    }
+    /**
+     * 最近动作日志 (SignalCollector.#collectActionSignals)
+     */
+    async findRecentActions(sinceTs, limit) {
+        return this.drizzle
+            .select({
+            actor: this.table.actor,
+            action: this.table.action,
+            resource: this.table.resource,
+            result: this.table.result,
+            timestamp: this.table.timestamp,
+        })
+            .from(this.table)
+            .where(gt(this.table.timestamp, sinceTs))
+            .orderBy(desc(this.table.timestamp))
+            .limit(limit)
+            .all();
+    }
+    /* ─── 内部辅助 ─── */
+    #mapRow(row) {
+        return {
+            id: row.id,
+            timestamp: row.timestamp,
+            actor: row.actor,
+            actorContext: safeParseJSON(row.actorContext, {}),
+            action: row.action,
+            resource: row.resource ?? null,
+            operationData: safeParseJSON(row.operationData, {}),
+            result: row.result,
+            errorMessage: row.errorMessage ?? null,
+            duration: row.duration ?? null,
+        };
+    }
+}
+function safeParseJSON(str, fallback) {
+    try {
+        return str ? JSON.parse(str) : fallback;
+    }
+    catch {
+        return fallback;
+    }
+}

package/dist/lib/repository/base/RepositoryBase.d.ts

@@ -0,0 +1,46 @@
+/**
+ * RepositoryBase — Drizzle-first 仓储基类
+ *
+ * 与旧 BaseRepository 的区别：
+ * - 构造器接收 DrizzleDB 而非 raw Database
+ * - 子类应使用 Drizzle 类型安全 API 实现 CRUD
+ * - 保留 rawQuery() 作为复杂查询逃生舱
+ * - 无 _assertSafeColumn() —— Drizzle 自带列类型约束
+ */
+import type { SQLiteTable } from 'drizzle-orm/sqlite-core';
+import type { Logger as WinstonLogger } from 'winston';
+import type { DrizzleDB } from '../../infrastructure/database/drizzle/index.js';
+/** Drizzle 事务类型 */
+export type DrizzleTx = Parameters<Parameters<DrizzleDB['transaction']>[0]>[0];
+export interface PaginationOptions {
+    page?: number;
+    pageSize?: number;
+}
+export interface PaginatedResult<T> {
+    data: T[];
+    pagination: {
+        page: number;
+        pageSize: number;
+        total: number;
+        pages: number;
+    };
+}
+/**
+ * 新基类：以 Drizzle typed API 为主，raw SQL 为逃生舱。
+ *
+ * @typeParam TTable  Drizzle 表定义（如 typeof knowledgeEdges）
+ * @typeParam TEntity 领域实体类型
+ */
+export declare abstract class RepositoryBase<TTable extends SQLiteTable, TEntity> {
+    protected readonly drizzle: DrizzleDB;
+    protected readonly table: TTable;
+    protected readonly logger: WinstonLogger;
+    constructor(drizzle: DrizzleDB, table: TTable);
+    /**
+     * Drizzle 事务包装 — 所有 DB 变更意图应在事务内执行
+     */
+    protected transaction<R>(fn: (tx: DrizzleTx) => R): R;
+    abstract findById(id: string | number): Promise<TEntity | null>;
+    abstract create(data: unknown): Promise<TEntity>;
+    abstract delete(id: string | number): Promise<boolean>;
+}

package/dist/lib/repository/base/RepositoryBase.js

@@ -0,0 +1,32 @@
+/**
+ * RepositoryBase — Drizzle-first 仓储基类
+ *
+ * 与旧 BaseRepository 的区别：
+ * - 构造器接收 DrizzleDB 而非 raw Database
+ * - 子类应使用 Drizzle 类型安全 API 实现 CRUD
+ * - 保留 rawQuery() 作为复杂查询逃生舱
+ * - 无 _assertSafeColumn() —— Drizzle 自带列类型约束
+ */
+import Logger from '../../infrastructure/logging/Logger.js';
+/**
+ * 新基类：以 Drizzle typed API 为主，raw SQL 为逃生舱。
+ *
+ * @typeParam TTable  Drizzle 表定义（如 typeof knowledgeEdges）
+ * @typeParam TEntity 领域实体类型
+ */
+export class RepositoryBase {
+    drizzle;
+    table;
+    logger;
+    constructor(drizzle, table) {
+        this.drizzle = drizzle;
+        this.table = table;
+        this.logger = Logger.getInstance();
+    }
+    /**
+     * Drizzle 事务包装 — 所有 DB 变更意图应在事务内执行
+     */
+    transaction(fn) {
+        return this.drizzle.transaction(fn);
+    }
+}

package/dist/lib/repository/bootstrap/BootstrapRepository.d.ts

@@ -0,0 +1,94 @@
+/**
+ * BootstrapRepository — Bootstrap 快照的仓储实现
+ *
+ * 从 BootstrapSnapshot 提取的数据操作，
+ * 使用 Drizzle 类型安全 API 操作 bootstrap_snapshots + bootstrap_dim_files 表。
+ */
+import { bootstrapSnapshots } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+export interface BootstrapSnapshotEntity {
+    id: string;
+    sessionId: string | null;
+    projectRoot: string;
+    createdAt: string;
+    durationMs: number;
+    fileCount: number;
+    dimensionCount: number;
+    candidateCount: number;
+    primaryLang: string | null;
+    fileHashes: Record<string, string>;
+    dimensionMeta: Record<string, DimensionStatMeta>;
+    episodicData: Record<string, unknown> | null;
+    isIncremental: boolean;
+    parentId: string | null;
+    changedFiles: string[];
+    affectedDims: string[];
+    status: string;
+}
+export interface DimensionStatMeta {
+    candidateCount: number;
+    analysisChars: number;
+    referencedFiles: number;
+    durationMs: number;
+}
+export interface BootstrapSnapshotInsert {
+    id: string;
+    sessionId?: string | null;
+    projectRoot: string;
+    createdAt: string;
+    durationMs?: number;
+    fileCount?: number;
+    dimensionCount?: number;
+    candidateCount?: number;
+    primaryLang?: string | null;
+    fileHashes: Record<string, string>;
+    dimensionMeta: Record<string, DimensionStatMeta>;
+    episodicData?: unknown | null;
+    isIncremental?: boolean;
+    parentId?: string | null;
+    changedFiles?: string[];
+    affectedDims?: string[];
+    status?: string;
+}
+export interface DimFileInsert {
+    snapshotId: string;
+    dimId: string;
+    filePath: string;
+    role?: string;
+}
+export interface DimFileEntry {
+    dimId: string;
+    filePath: string;
+}
+export declare class BootstrapRepositoryImpl extends RepositoryBase<typeof bootstrapSnapshots, BootstrapSnapshotEntity> {
+    #private;
+    /** 默认快照保留数量 */
+    static readonly MAX_SNAPSHOTS = 5;
+    constructor(drizzle: ConstructorParameters<typeof RepositoryBase<typeof bootstrapSnapshots, BootstrapSnapshotEntity>>[0]);
+    findById(id: string): Promise<BootstrapSnapshotEntity | null>;
+    create(data: BootstrapSnapshotInsert): Promise<BootstrapSnapshotEntity>;
+    delete(id: string): Promise<boolean>;
+    /** 获取项目最新完成的快照 */
+    getLatest(projectRoot: string): Promise<BootstrapSnapshotEntity | null>;
+    /** 获取项目的快照列表 (按时间降序) */
+    listByProject(projectRoot: string, limit?: number): Promise<BootstrapSnapshotEntity[]>;
+    /** 批量插入维度-文件关联 (INSERT OR IGNORE) */
+    saveDimFiles(entries: DimFileInsert[]): Promise<number>;
+    /** 获取快照的维度-文件关联 */
+    getDimFiles(snapshotId: string): Promise<DimFileEntry[]>;
+    /** 获取快照中每个维度引用的文件集合 */
+    getDimFileMap(snapshotId: string): Promise<Record<string, Set<string>>>;
+    /** 保留项目最新 N 个快照，删除旧的 */
+    enforceCapacity(projectRoot: string, maxSnapshots?: number): Promise<number>;
+    /** 清除项目的所有快照 */
+    clearProject(projectRoot: string): Promise<number>;
+    /**
+     * 事务保存快照 + 维度-文件关联 + 容量控制
+     * 替代 BootstrapSnapshot.save() 中的事务逻辑
+     */
+    saveWithDimFiles(snapshot: BootstrapSnapshotInsert, dimFiles: DimFileInsert[]): Promise<BootstrapSnapshotEntity>;
+    /** 获取项目最新的主语言 (Panorama 域用于维度/角色检测) */
+    getLatestPrimaryLang(projectRoot: string): Promise<string | null>;
+    /** 获取快照总数 */
+    getSnapshotCount(projectRoot?: string): Promise<number>;
+}

package/dist/lib/repository/bootstrap/BootstrapRepository.js

@@ -0,0 +1,246 @@
+/**
+ * BootstrapRepository — Bootstrap 快照的仓储实现
+ *
+ * 从 BootstrapSnapshot 提取的数据操作，
+ * 使用 Drizzle 类型安全 API 操作 bootstrap_snapshots + bootstrap_dim_files 表。
+ */
+import { and, count, desc, eq, sql } from 'drizzle-orm';
+import { bootstrapDimFiles, bootstrapSnapshots, } from '../../infrastructure/database/drizzle/schema.js';
+import { RepositoryBase } from '../base/RepositoryBase.js';
+/* ═══ Repository 实现 ═══ */
+export class BootstrapRepositoryImpl extends RepositoryBase {
+    /** 默认快照保留数量 */
+    static MAX_SNAPSHOTS = 5;
+    constructor(drizzle) {
+        super(drizzle, bootstrapSnapshots);
+    }
+    /* ─── 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) {
+        this.drizzle
+            .insert(this.table)
+            .values({
+            id: data.id,
+            sessionId: data.sessionId ?? null,
+            projectRoot: data.projectRoot,
+            createdAt: data.createdAt,
+            durationMs: data.durationMs ?? 0,
+            fileCount: data.fileCount ?? 0,
+            dimensionCount: data.dimensionCount ?? 0,
+            candidateCount: data.candidateCount ?? 0,
+            primaryLang: data.primaryLang ?? null,
+            fileHashes: JSON.stringify(data.fileHashes),
+            dimensionMeta: JSON.stringify(data.dimensionMeta),
+            episodicData: data.episodicData ? JSON.stringify(data.episodicData) : null,
+            isIncremental: data.isIncremental ? 1 : 0,
+            parentId: data.parentId ?? null,
+            changedFiles: JSON.stringify(data.changedFiles ?? []),
+            affectedDims: JSON.stringify(data.affectedDims ?? []),
+            status: data.status ?? 'complete',
+        })
+            .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 getLatest(projectRoot) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(and(eq(this.table.projectRoot, projectRoot), eq(this.table.status, 'complete')))
+            .orderBy(desc(this.table.createdAt))
+            .limit(1)
+            .all();
+        return rows.length > 0 ? this.#mapRow(rows[0]) : null;
+    }
+    /** 获取项目的快照列表 (按时间降序) */
+    async listByProject(projectRoot, limit = 10) {
+        const rows = this.drizzle
+            .select()
+            .from(this.table)
+            .where(eq(this.table.projectRoot, projectRoot))
+            .orderBy(desc(this.table.createdAt))
+            .limit(limit)
+            .all();
+        return rows.map((r) => this.#mapRow(r));
+    }
+    /* ─── 维度-文件关联 ─── */
+    /** 批量插入维度-文件关联 (INSERT OR IGNORE) */
+    async saveDimFiles(entries) {
+        if (entries.length === 0) {
+            return 0;
+        }
+        let inserted = 0;
+        this.transaction((tx) => {
+            for (const entry of entries) {
+                tx.insert(bootstrapDimFiles)
+                    .values({
+                    snapshotId: entry.snapshotId,
+                    dimId: entry.dimId,
+                    filePath: entry.filePath,
+                    role: entry.role ?? 'referenced',
+                })
+                    .onConflictDoNothing()
+                    .run();
+                inserted++;
+            }
+        });
+        return inserted;
+    }
+    /** 获取快照的维度-文件关联 */
+    async getDimFiles(snapshotId) {
+        const rows = this.drizzle
+            .select({
+            dimId: bootstrapDimFiles.dimId,
+            filePath: bootstrapDimFiles.filePath,
+        })
+            .from(bootstrapDimFiles)
+            .where(eq(bootstrapDimFiles.snapshotId, snapshotId))
+            .all();
+        return rows;
+    }
+    /** 获取快照中每个维度引用的文件集合 */
+    async getDimFileMap(snapshotId) {
+        const entries = await this.getDimFiles(snapshotId);
+        const map = {};
+        for (const row of entries) {
+            if (!map[row.dimId]) {
+                map[row.dimId] = new Set();
+            }
+            map[row.dimId].add(row.filePath);
+        }
+        return map;
+    }
+    /* ─── 容量控制 ─── */
+    /** 保留项目最新 N 个快照，删除旧的 */
+    async enforceCapacity(projectRoot, maxSnapshots = BootstrapRepositoryImpl.MAX_SNAPSHOTS) {
+        const result = this.drizzle
+            .delete(this.table)
+            .where(and(eq(this.table.projectRoot, projectRoot), sql `${this.table.id} NOT IN (
+            SELECT ${this.table.id} FROM ${this.table}
+            WHERE ${this.table.projectRoot} = ${projectRoot}
+            ORDER BY ${this.table.createdAt} DESC
+            LIMIT ${maxSnapshots}
+          )`))
+            .run();
+        return result.changes;
+    }
+    /** 清除项目的所有快照 */
+    async clearProject(projectRoot) {
+        const snapshots = await this.listByProject(projectRoot, 9999);
+        let deleted = 0;
+        for (const snap of snapshots) {
+            if (await this.delete(snap.id)) {
+                deleted++;
+            }
+        }
+        return deleted;
+    }
+    /* ─── 事务保存 ─── */
+    /**
+     * 事务保存快照 + 维度-文件关联 + 容量控制
+     * 替代 BootstrapSnapshot.save() 中的事务逻辑
+     */
+    async saveWithDimFiles(snapshot, dimFiles) {
+        this.transaction((tx) => {
+            // 主记录
+            tx.insert(this.table)
+                .values({
+                id: snapshot.id,
+                sessionId: snapshot.sessionId ?? null,
+                projectRoot: snapshot.projectRoot,
+                createdAt: snapshot.createdAt,
+                durationMs: snapshot.durationMs ?? 0,
+                fileCount: snapshot.fileCount ?? 0,
+                dimensionCount: snapshot.dimensionCount ?? 0,
+                candidateCount: snapshot.candidateCount ?? 0,
+                primaryLang: snapshot.primaryLang ?? null,
+                fileHashes: JSON.stringify(snapshot.fileHashes),
+                dimensionMeta: JSON.stringify(snapshot.dimensionMeta),
+                episodicData: snapshot.episodicData ? JSON.stringify(snapshot.episodicData) : null,
+                isIncremental: snapshot.isIncremental ? 1 : 0,
+                parentId: snapshot.parentId ?? null,
+                changedFiles: JSON.stringify(snapshot.changedFiles ?? []),
+                affectedDims: JSON.stringify(snapshot.affectedDims ?? []),
+                status: snapshot.status ?? 'complete',
+            })
+                .run();
+            // 维度-文件关联
+            for (const df of dimFiles) {
+                tx.insert(bootstrapDimFiles)
+                    .values({
+                    snapshotId: df.snapshotId,
+                    dimId: df.dimId,
+                    filePath: df.filePath,
+                    role: df.role ?? 'referenced',
+                })
+                    .onConflictDoNothing()
+                    .run();
+            }
+            // 容量控制
+            tx.delete(this.table)
+                .where(and(eq(this.table.projectRoot, snapshot.projectRoot), sql `${this.table.id} NOT IN (
+              SELECT ${this.table.id} FROM ${this.table}
+              WHERE ${this.table.projectRoot} = ${snapshot.projectRoot}
+              ORDER BY ${this.table.createdAt} DESC
+              LIMIT ${BootstrapRepositoryImpl.MAX_SNAPSHOTS}
+            )`))
+                .run();
+        });
+        return (await this.findById(snapshot.id));
+    }
+    /** 获取项目最新的主语言 (Panorama 域用于维度/角色检测) */
+    async getLatestPrimaryLang(projectRoot) {
+        const rows = this.drizzle
+            .select({ primaryLang: this.table.primaryLang })
+            .from(this.table)
+            .where(eq(this.table.projectRoot, projectRoot))
+            .orderBy(desc(this.table.createdAt))
+            .limit(1)
+            .all();
+        return rows.length > 0 ? (rows[0].primaryLang ?? null) : null;
+    }
+    /** 获取快照总数 */
+    async getSnapshotCount(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;
+    }
+    /* ─── 内部辅助 ─── */
+    #mapRow(row) {
+        return {
+            id: row.id,
+            sessionId: row.sessionId ?? null,
+            projectRoot: row.projectRoot,
+            createdAt: row.createdAt,
+            durationMs: row.durationMs ?? 0,
+            fileCount: row.fileCount ?? 0,
+            dimensionCount: row.dimensionCount ?? 0,
+            candidateCount: row.candidateCount ?? 0,
+            primaryLang: row.primaryLang ?? null,
+            fileHashes: safeParseJSON(row.fileHashes, {}),
+            dimensionMeta: safeParseJSON(row.dimensionMeta, {}),
+            episodicData: safeParseJSON(row.episodicData, null),
+            isIncremental: !!row.isIncremental,
+            parentId: row.parentId ?? null,
+            changedFiles: safeParseJSON(row.changedFiles, []),
+            affectedDims: safeParseJSON(row.affectedDims, []),
+            status: row.status ?? 'complete',
+        };
+    }
+}
+function safeParseJSON(str, fallback) {
+    try {
+        return str ? JSON.parse(str) : fallback;
+    }
+    catch {
+        return fallback;
+    }
+}