soloforge 1.1.44 → 1.1.46

package/dist/gate/migration_guard.js

@@ -1,277 +0,0 @@
-/**
- * Migration Guard — 模块模块。
- *
- * 职责边界：
- * - 负责：analyzeMigration 等 模块职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：上层模块按需调用
- * 调用谁：index、logger
- *
- * 数据流：输入 → analyzeMigration 处理 → 输出
- * 持久化：无持久化（纯计算/内存态）
- */
-import { debug } from "../shared/logger.js";
-/**
- * 数据库迁移守卫 — 逐行分析 SQL 迁移脚本，检测高风险操作（DROP TABLE、DELETE 无 WHERE 等），
- * 并生成中文风险摘要和回滚建议。纯规则匹配，零 AI 依赖。
- */
-/** 回滚建议模板 — 按 SQL 语句类型映射到对应的回滚操作建议 */
-// ── 回滚建议模板（按语句类型索引） ──
-const ROLLBACK_SUGGESTIONS = {
-    DROP_TABLE: "恢复数据需要从备份还原，建议先创建备份",
-    DROP_COLUMN: "此操作不可逆，建议先迁移数据到新列",
-    DELETE_NO_WHERE: "建议添加 WHERE 条件或使用事务包装",
-    ALTER_COLUMN: "修改列类型前建议备份数据，并验证兼容性",
-    TRUNCATE: "清空操作不可逆，建议先创建数据备份",
-    ADD_NOT_NULL: "建议添加 DEFAULT 值或分步执行（先加可为空列→回填→改非空）",
-    RENAME: "重命名操作需确认无其他代码引用该名称",
-    ADD_INDEX: "大表添加索引可能造成长时间锁表，建议在低峰期执行",
-    ADD_FK: "添加外键前建议确认引用完整性，并在低峰期执行",
-};
-/**
- * 从 SQL 行中提取表名 — 支持 TABLE/FROM/INTO 三种常见语法位置。
- * @param line - 已转大写的 SQL 行
- * @returns 提取到的表名，未匹配时返回 undefined
- */
-function extractTableFrom(line) {
-    // TABLE <name>（覆盖 DROP TABLE、ALTER TABLE、CREATE TABLE、RENAME TABLE）
-    const tableMatch = line.match(/TABLE\s+(\w+)/);
-    if (tableMatch)
-        return tableMatch[1];
-    // FROM <name>（覆盖 DELETE FROM、INSERT INTO）
-    const fromMatch = line.match(/FROM\s+(\w+)/);
-    if (fromMatch)
-        return fromMatch[1];
-    // INTO <name>（覆盖 INSERT INTO）
-    const intoMatch = line.match(/INTO\s+(\w+)/);
-    if (intoMatch)
-        return intoMatch[1];
-    return undefined;
-}
-/** 高风险规则集 — 检测 DROP TABLE、DROP COLUMN、修改列类型、DELETE 无 WHERE、TRUNCATE 等危险操作 */
-const CRITICAL_RULES = [
-    {
-        test: (upper) => /DROP\s+TABLE/.test(upper),
-        type: "DROP_TABLE",
-        risk: "critical",
-        description: "删除表操作，数据不可恢复",
-    },
-    {
-        test: (upper) => /DROP\s+COLUMN/.test(upper),
-        type: "DROP_COLUMN",
-        risk: "critical",
-        description: "删除列操作，数据不可恢复",
-    },
-    {
-        test: (upper, _raw) => {
-            if (!/ALTER\s+COLUMN/.test(upper) && !/ALTER\s+TABLE\b/.test(upper))
-                return false;
-            // 检测列类型变更模式: TYPE、USING、SET DATA TYPE 关键字
-            return /TYPE\s|SET\s+DATA\s+TYPE\s|USING\s/.test(upper);
-        },
-        type: "ALTER_COLUMN",
-        risk: "critical",
-        description: "修改列类型可能导致数据丢失",
-    },
-    {
-        test: (upper) => /MODIFY\s+COLUMN/.test(upper),
-        type: "ALTER_COLUMN",
-        risk: "critical",
-        description: "MySQL MODIFY COLUMN 修改列类型可能导致数据丢失",
-    },
-    {
-        test: (upper) => /CHANGE\s+COLUMN/.test(upper),
-        type: "ALTER_COLUMN",
-        risk: "critical",
-        description: "MySQL CHANGE COLUMN 修改列定义可能导致数据丢失",
-    },
-    {
-        test: (upper, _raw, _lines, _lineIndex) => {
-            if (!/DELETE\s+FROM/.test(upper))
-                return false;
-            // 当前行无 WHERE — 向后预查最多 10 行，寻找 WHERE 子句或语句结束符(;)
-            if (/WHERE\b/.test(upper))
-                return false;
-            // 向后预查最多 10 行，若遇到分号则语句结束
-            const lines = _lines;
-            const startIdx = _lineIndex;
-            const lookAheadLimit = Math.min(lines.length, startIdx + 10);
-            for (let j = startIdx + 1; j < lookAheadLimit; j++) {
-                const futureLine = lines[j].trim().toUpperCase();
-                if (futureLine.startsWith("--"))
-                    continue; // 跳过注释行
-                if (/WHERE\b/.test(futureLine))
-                    return false;
-                if (/;\s*$/.test(futureLine) || futureLine.endsWith(";"))
-                    break; // 语句结束
-            }
-            return true;
-        },
-        type: "DELETE_NO_WHERE",
-        risk: "critical",
-        description: "无条件删除，将清空表数据",
-    },
-    {
-        test: (upper) => /TRUNCATE\s+TABLE/.test(upper) || /TRUNCATE\b/.test(upper),
-        type: "TRUNCATE",
-        risk: "critical",
-        description: "清空表操作",
-    },
-];
-/** 警告规则集 — 检测 ADD COLUMN 无 DEFAULT 的 NOT NULL、RENAME、添加索引、添加外键等需谨慎操作 */
-const WARNING_RULES = [
-    {
-        test: (upper, _raw) => {
-            if (!/ADD\s+COLUMN/.test(upper))
-                return false;
-            // 存在 NOT NULL 但无 DEFAULT
-            return /NOT\s+NULL/.test(upper) && !/DEFAULT\s/.test(upper);
-        },
-        type: "ADD_NOT_NULL",
-        risk: "warning",
-        description: "添加非空列无默认值，需回填数据",
-    },
-    {
-        test: (upper) => /RENAME\s+(TABLE|COLUMN)/.test(upper),
-        type: "RENAME",
-        risk: "warning",
-        description: "重命名操作，需确认无其他引用",
-    },
-    {
-        test: (upper) => /ADD\s+(UNIQUE\s+)?INDEX|CREATE\s+(UNIQUE\s+)?INDEX/.test(upper),
-        type: "ADD_INDEX",
-        risk: "warning",
-        description: "添加索引可能导致锁表",
-    },
-    {
-        test: (upper) => /ADD\s+CONSTRAINT\b/.test(upper) && /FOREIGN\s+KEY/.test(upper),
-        type: "ADD_FK",
-        risk: "warning",
-        description: "添加外键约束，需确认引用完整性",
-    },
-];
-/** 安全规则集 — 检测 CREATE TABLE、ADD COLUMN（可空/有默认值）、INSERT、COMMENT 等低风险操作 */
-const SAFE_RULES = [
-    {
-        test: (upper) => /CREATE\s+TABLE/.test(upper),
-        type: "CREATE_TABLE",
-        risk: "safe",
-        description: "创建表操作",
-    },
-    {
-        test: (upper, _raw) => {
-            if (!/ADD\s+COLUMN/.test(upper))
-                return false;
-            // 明确指定为可空，或有默认值
-            const hasNull = /\bNULL\b/.test(upper) && !/NOT\s+NULL/.test(upper);
-            const hasDefault = /DEFAULT\s/.test(upper);
-            return hasNull || hasDefault;
-        },
-        type: "ADD_COLUMN",
-        risk: "safe",
-        description: "添加列操作",
-    },
-    {
-        test: (upper) => /INSERT\s+INTO/.test(upper),
-        type: "INSERT",
-        risk: "safe",
-        description: "插入数据操作",
-    },
-    {
-        test: (upper) => /COMMENT\s+ON/.test(upper),
-        type: "COMMENT",
-        risk: "safe",
-        description: "添加注释操作",
-    },
-    {
-        test: (upper) => {
-            // ALTER TABLE ... ADD COLUMN ... DEFAULT（安全变体）
-            return /ALTER\s+TABLE/.test(upper) && /ADD\s+COLUMN/.test(upper) && /DEFAULT\s/.test(upper);
-        },
-        type: "ADD_COLUMN_DEFAULT",
-        risk: "safe",
-        description: "添加带默认值的列",
-    },
-];
-// 合并所有规则，按优先级排列（critical → warning → safe），每行匹配到第一条规则即停止
-const ALL_RULES = [...CRITICAL_RULES, ...WARNING_RULES, ...SAFE_RULES];
-// ── 公共 API ──
-/**
- * 分析 SQL 迁移脚本 — 逐行匹配规则，生成风险评级、语句列表和回滚建议。
- * @param content - SQL 迁移文件内容
- * @param filename - 文件名（用于结果标识）
- * @returns 迁移分析结果，包含风险等级(critical/warning/safe)、语句列表、回滚建议和中文摘要
- */
-export function analyzeMigration(content, filename) {
-    debug("迁移守卫", `开始分析 ${filename}`);
-    const lines = content.split("\n");
-    const statements = [];
-    const seenRollbackSuggestions = new Set();
-    if (lines.length === 0) {
-        debug("迁移守卫", "文件内容为空", filename);
-    }
-    for (let i = 0; i < lines.length; i++) {
-        const raw = lines[i].trim();
-        // 跳过空行和纯注释行
-        if (raw === "" || raw.startsWith("--"))
-            continue;
-        const upper = raw.toUpperCase();
-        // 按优先级顺序尝试匹配规则（critical → warning → safe），首条命中即终止
-        for (const rule of ALL_RULES) {
-            if (rule.test(upper, raw, lines, i)) {
-                const table = extractTableFrom(upper);
-                statements.push({
-                    line: i + 1,
-                    type: rule.type,
-                    table,
-                    risk: rule.risk,
-                    description: rule.description,
-                });
-                // 收集唯一的回滚建议
-                const suggestion = ROLLBACK_SUGGESTIONS[rule.type];
-                if (suggestion) {
-                    seenRollbackSuggestions.add(suggestion);
-                }
-                // 每行仅匹配第一条规则
-                break;
-            }
-        }
-    }
-    // 确定整体风险等级: 有 critical 则为 critical，有 warning 则为 warning，否则 safe
-    const hasCritical = statements.some((s) => s.risk === "critical");
-    const hasWarning = statements.some((s) => s.risk === "warning");
-    if (hasCritical)
-        debug("迁移守卫", `检测到高风险语句，请人工审核 ${filename}`);
-    else if (hasWarning)
-        debug("迁移守卫", `检测到警告级语句 ${filename}`);
-    const risk_level = hasCritical
-        ? "critical"
-        : hasWarning
-            ? "warning"
-            : "safe";
-    // 按风险等级统计数量
-    const criticalCount = statements.filter((s) => s.risk === "critical").length;
-    const warningCount = statements.filter((s) => s.risk === "warning").length;
-    const safeCount = statements.filter((s) => s.risk === "safe").length;
-    // 生成中文摘要
-    const summary = `检测到 ${statements.length} 条语句：${criticalCount} 条高风险，${warningCount} 条警告，${safeCount} 条安全`;
-    // 回滚建议按原始出现顺序排列，仅保留非安全操作的唯一建议
-    const rollbackSuggestions = statements
-        .filter((s) => s.risk !== "safe" && ROLLBACK_SUGGESTIONS[s.type])
-        .reduce((acc, s) => {
-        const text = ROLLBACK_SUGGESTIONS[s.type];
-        if (text && !acc.includes(text))
-            acc.push(text);
-        return acc;
-    }, []);
-    debug("迁移守卫", `分析完成 ${filename} — ${summary}`);
-    return {
-        file: filename,
-        risk_level,
-        statements,
-        rollback_suggestions: rollbackSuggestions,
-        summary,
-    };
-}
-//# sourceMappingURL=migration_guard.js.map

package/dist/gate/migration_guard.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"migration_guard.js","sourceRoot":"","sources":["../../src/gate/migration_guard.ts"],"names":[],"mappings":"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"}

package/dist/gate/scope_lease.d.ts

@@ -1,94 +0,0 @@
-/**
- * Scope Lease — 管线层模块。
- *
- * 职责边界：
- * - 负责：LeaseEntry 等 管线层职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：状态机、工具层
- * 调用谁：node:fs、node:path、logger、helpers、path_scope_utils
- *
- * 数据流：用户意图 → 解析/扩展 → 执行 → 输出
- * 持久化：读写本地文件（详见代码内路径）
- */
-/** 租约条目 */
-export interface LeaseEntry {
-    task_id: string;
-    file_paths: string[];
-    acquired_at: string;
-    released_at: string | null;
-}
-/** 租约冲突信息 */
-export interface LeaseConflict {
-    file_path: string;
-    leased_by: string;
-    lease_acquired_at: string;
-    severity: "advisory";
-    message: string;
-}
-/** 租约摘要 */
-export interface LeaseSummary {
-    active_leases: number;
-    total_files_leased: number;
-    leased_by_task: Record<string, string[]>;
-}
-/** 范围租约存储 */
-export declare class ScopeLeaseStore {
-    private filePath;
-    private leases;
-    private loaded;
-    /**
-     * 创建范围租约存储实例。
-     * @param stateDir - 状态存储目录路径
-     */
-    constructor(stateDir: string);
-    /** 从磁盘加载租约数据（首次访问时自动调用） */
-    private ensureLoaded;
-    /** 将租约数据持久化到磁盘 */
-    private persist;
-    /**
-     * 为任务获取文件范围租约。
-     * @param taskId - 任务 ID
-     * @param filePaths - 任务操作的文件路径列表
-     * @returns 创建的租约条目
-     */
-    acquire(taskId: string, filePaths: string[]): LeaseEntry;
-    /**
-     * 释放任务的文件范围租约。
-     * 释放前检查是否有其他活跃任务持有重叠路径。
-     * @param taskId - 任务 ID
-     * @returns 释放结果，包含是否成功和冲突警告
-     */
-    release(taskId: string): {
-        released: boolean;
-        warnings: string[];
-    };
-    /**
-     * 查询指定文件是否存在与其他任务的租约冲突。
-     * @param taskId - 当前任务 ID（排除自身）
-     * @param filePath - 要查询的文件路径
-     * @returns 租约冲突信息，无冲突时返回 null
-     */
-    queryLease(taskId: string, filePath: string): LeaseConflict | null;
-    /**
-     * 获取所有活跃的租约列表。
-     * @returns 活跃租约条目数组
-     */
-    getActiveLeases(): LeaseEntry[];
-    /**
-     * 获取指定任务的租约信息。
-     * @param taskId - 任务 ID
-     * @returns 对应的租约条目，未找到时返回 null
-     */
-    getLeaseForTask(taskId: string): LeaseEntry | null;
-    /**
-     * 获取租约摘要统计。
-     * @returns 租约摘要信息
-     */
-    getSummary(): LeaseSummary;
-    /**
-     * 清除所有租约数据。
-     */
-    clear(): void;
-}
-//# sourceMappingURL=scope_lease.d.ts.map

package/dist/gate/scope_lease.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope_lease.d.ts","sourceRoot":"","sources":["../../src/gate/scope_lease.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAQH,WAAW;AACX,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;CAC5B;AAED,aAAa;AACb,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,UAAU,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,WAAW;AACX,MAAM,WAAW,YAAY;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;CAC1C;AAED,aAAa;AACb,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAsC;IACpD,OAAO,CAAC,MAAM,CAAS;IAEvB;;;OAGG;gBACS,QAAQ,EAAE,MAAM;IAK5B,2BAA2B;IAC3B,OAAO,CAAC,YAAY;IAgBpB,kBAAkB;IAClB,OAAO,CAAC,OAAO;IAOf;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,UAAU;IAexD;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG;QAAE,QAAQ,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE;IA0BlE;;;;;OAKG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI;IAoBlE;;;OAGG;IACH,eAAe,IAAI,UAAU,EAAE;IAK/B;;;;OAIG;IACH,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI;IAKlD;;;OAGG;IACH,UAAU,IAAI,YAAY;IAe1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAMd"}

package/dist/gate/scope_lease.js

@@ -1,180 +0,0 @@
-/**
- * Scope Lease — 管线层模块。
- *
- * 职责边界：
- * - 负责：LeaseEntry 等 管线层职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：状态机、工具层
- * 调用谁：node:fs、node:path、logger、helpers、path_scope_utils
- *
- * 数据流：用户意图 → 解析/扩展 → 执行 → 输出
- * 持久化：读写本地文件（详见代码内路径）
- */
-import fs from "node:fs";
-import path from "node:path";
-import { debug } from "../shared/logger.js";
-import { safeJsonParse } from "../shared/helpers.js";
-import { isPathInScope } from "../shared/path_scope_utils.js";
-/** 范围租约存储 */
-export class ScopeLeaseStore {
-    filePath;
-    leases = new Map();
-    loaded = false;
-    /**
-     * 创建范围租约存储实例。
-     * @param stateDir - 状态存储目录路径
-     */
-    constructor(stateDir) {
-        fs.mkdirSync(stateDir, { recursive: true });
-        this.filePath = path.join(stateDir, "scope-leases.json");
-    }
-    /** 从磁盘加载租约数据（首次访问时自动调用） */
-    ensureLoaded() {
-        if (this.loaded)
-            return;
-        this.loaded = true;
-        try {
-            const data = fs.readFileSync(this.filePath, "utf-8");
-            const entries = safeJsonParse(data) ?? [];
-            for (const e of entries) {
-                if (e.released_at === null) {
-                    this.leases.set(e.task_id, e);
-                }
-            }
-        }
-        catch {
-            this.leases = new Map();
-        }
-    }
-    /** 将租约数据持久化到磁盘 */
-    persist() {
-        const entries = [...this.leases.values()];
-        const tmpPath = `${this.filePath}.tmp`;
-        fs.writeFileSync(tmpPath, JSON.stringify(entries, null, 2));
-        fs.renameSync(tmpPath, this.filePath);
-    }
-    /**
-     * 为任务获取文件范围租约。
-     * @param taskId - 任务 ID
-     * @param filePaths - 任务操作的文件路径列表
-     * @returns 创建的租约条目
-     */
-    acquire(taskId, filePaths) {
-        debug("ScopeLease", "获取租约", taskId, "文件数:", filePaths.length);
-        this.ensureLoaded();
-        const resolved = filePaths.map(f => path.resolve(f));
-        const entry = {
-            task_id: taskId,
-            file_paths: resolved,
-            acquired_at: new Date().toISOString(),
-            released_at: null,
-        };
-        this.leases.set(taskId, entry);
-        this.persist();
-        return entry;
-    }
-    /**
-     * 释放任务的文件范围租约。
-     * 释放前检查是否有其他活跃任务持有重叠路径。
-     * @param taskId - 任务 ID
-     * @returns 释放结果，包含是否成功和冲突警告
-     */
-    release(taskId) {
-        debug("ScopeLease", "释放租约", taskId);
-        this.ensureLoaded();
-        const entry = this.leases.get(taskId);
-        if (!entry || entry.released_at) {
-            return { released: false, warnings: [] };
-        }
-        // 检查是否有其他活跃任务依赖相同文件路径
-        const warnings = [];
-        for (const [otherId, other] of this.leases) {
-            if (otherId === taskId || other.released_at)
-                continue;
-            const overlap = entry.file_paths.some(p => other.file_paths.some(op => op === p || op.startsWith(p + "/") || p.startsWith(op + "/")));
-            if (overlap) {
-                warnings.push(`任务 ${otherId} 的 scope 与本任务有重叠，释放后可能出现写入冲突`);
-            }
-        }
-        entry.released_at = new Date().toISOString();
-        this.leases.delete(taskId);
-        this.persist();
-        return { released: true, warnings };
-    }
-    /**
-     * 查询指定文件是否存在与其他任务的租约冲突。
-     * @param taskId - 当前任务 ID（排除自身）
-     * @param filePath - 要查询的文件路径
-     * @returns 租约冲突信息，无冲突时返回 null
-     */
-    queryLease(taskId, filePath) {
-        this.ensureLoaded();
-        const resolved = path.resolve(filePath);
-        for (const [ownerId, entry] of this.leases) {
-            if (ownerId === taskId)
-                continue;
-            for (const leased of entry.file_paths) {
-                if (leased === resolved || isParentPath(leased, resolved)) {
-                    return {
-                        file_path: resolved,
-                        leased_by: ownerId,
-                        lease_acquired_at: entry.acquired_at,
-                        severity: "advisory",
-                        message: `advisory: file is in scope of task ${ownerId} (leased since ${entry.acquired_at})`,
-                    };
-                }
-            }
-        }
-        return null;
-    }
-    /**
-     * 获取所有活跃的租约列表。
-     * @returns 活跃租约条目数组
-     */
-    getActiveLeases() {
-        this.ensureLoaded();
-        return [...this.leases.values()];
-    }
-    /**
-     * 获取指定任务的租约信息。
-     * @param taskId - 任务 ID
-     * @returns 对应的租约条目，未找到时返回 null
-     */
-    getLeaseForTask(taskId) {
-        this.ensureLoaded();
-        return this.leases.get(taskId) ?? null;
-    }
-    /**
-     * 获取租约摘要统计。
-     * @returns 租约摘要信息
-     */
-    getSummary() {
-        this.ensureLoaded();
-        const leasedByTask = {};
-        let totalFiles = 0;
-        for (const [taskId, entry] of this.leases) {
-            leasedByTask[taskId] = [...entry.file_paths];
-            totalFiles += entry.file_paths.length;
-        }
-        return {
-            active_leases: this.leases.size,
-            total_files_leased: totalFiles,
-            leased_by_task: leasedByTask,
-        };
-    }
-    /**
-     * 清除所有租约数据。
-     */
-    clear() {
-        debug("ScopeLease", "清除所有租约");
-        this.leases.clear();
-        this.loaded = true;
-        this.persist();
-    }
-}
-/** 判断 child 路径是否在 parent 路径下 */
-function isParentPath(parent, child) {
-    return isPathInScope(child, parent, { caseSensitive: true });
-}
-//# sourceMappingURL=scope_lease.js.map

package/dist/gate/scope_lease.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scope_lease.js","sourceRoot":"","sources":["../../src/gate/scope_lease.ts"],"names":[],"mappings":"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"}

package/dist/git/git_deps.d.ts

@@ -1,85 +0,0 @@
-/**
- * Git Deps — Git 集成层模块。
- *
- * 职责边界：
- * - 负责：GitOperations 等 Git 集成层职责
- * - 不负责：不属于本模块的职责由对应模块承担
- *
- * 被谁调用：上层模块按需调用
- * 调用谁：operations、logger
- *
- * 数据流：输入 → GitOperations 处理 → 输出
- * 持久化：无持久化（纯计算/内存态）
- */
-import type { GitFileStatus, GitLogEntry, GitDiffHunk, GitBlameLine } from "./operations.js";
-/**
- * Git 操作依赖注入模块。
- * @description 定义 GitOperations 接口作为抽象层，并导出基于真实 Git 命令的实现（realGitOps）。
- *              使用依赖注入模式，便于测试时替换为 mock 实现。
- *
- *              位置: src/git/git_deps.ts（从 engine/core/ 移出，恢复 core/ 零反向依赖）
- */
-/**
- * Git 操作抽象接口。
- * @description 封装所有项目需要的 Git 操作，包括仓库查询、状态检查、日志查看、
- *              差异比较、分支管理和远程操作等。
- */
-export interface GitOperations {
-    /** 检查指定目录是否为 Git 仓库 */
-    isGitRepo(cwd: string): Promise<boolean>;
-    /** 获取 Git 仓库根目录路径 */
-    getRootDir(cwd: string): Promise<string>;
-    /** 获取当前分支名称 */
-    getCurrentBranch(cwd: string): Promise<string>;
-    /** 检查工作区是否干净（无未提交变更） */
-    isClean(cwd: string): Promise<boolean>;
-    /** 获取工作区文件状态列表 */
-    getStatus(cwd: string): Promise<GitFileStatus[]>;
-    /** 获取提交日志，支持按数量、时间、作者和路径过滤 */
-    getLog(cwd: string, options?: {
-        maxCount?: number;
-        since?: string;
-        author?: string;
-        path?: string;
-        ref?: string;
-    }): Promise<GitLogEntry[]>;
-    /** 获取简短日志摘要（按作者分组统计提交数） */
-    getShortlog(cwd: string, since?: string): Promise<Array<{
-        author: string;
-        count: number;
-    }>>;
-    /** 获取差异信息（结构化 Hunk 列表） */
-    getDiff(cwd: string, options?: {
-        cached?: boolean;
-        path?: string;
-    }): Promise<GitDiffHunk[]>;
-    /** 获取指定文件的差异补丁文本 */
-    getDiffPatch(cwd: string, filePath: string, options?: {
-        cached?: boolean;
-    }): Promise<string>;
-    /** 获取指定文件的逐行 Blame 信息 */
-    getBlame(cwd: string, filePath: string): Promise<GitBlameLine[]>;
-    /** 列出所有本地分支及其当前标记 */
-    listBranches(cwd: string): Promise<Array<{
-        name: string;
-        isCurrent: boolean;
-    }>>;
-    /** 将文件添加到暂存区 */
-    add(cwd: string, paths: string[]): Promise<void>;
-    /** 创建提交，返回提交 SHA */
-    commit(cwd: string, message: string): Promise<string>;
-    /** 推送到远程仓库，返回推送结果 */
-    push(cwd: string, remote?: string, branch?: string): Promise<string>;
-    /** 获取两个分支的最新公共祖先提交 SHA */
-    getMergeBase(cwd: string, branchA: string, branchB: string): Promise<string>;
-    /** 获取远程仓库 URL，不存在则返回 null */
-    getRemoteUrl(cwd: string, remote?: string): Promise<string | null>;
-    /** 获取 HEAD 的短 commit hash */
-    getHeadCommitHash(cwd: string): Promise<string>;
-}
-/**
- * 基于真实 Git 命令的 GitOperations 实现。
- * @description 导出 realGitOps 实例，将所有 Git 操作委托给真实的 git 命令行工具。
- */
-export declare const realGitOps: GitOperations;
-//# sourceMappingURL=git_deps.d.ts.map

package/dist/git/git_deps.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"git_deps.d.ts","sourceRoot":"","sources":["../../src/git/git_deps.ts"],"names":[],"mappings":"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"}