@accelerator-mzq/forge 1.4.0

package/dist/core/migrate/ack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ack.js","sourceRoot":"","sources":["../../../src/core/migrate/ack.ts"],"names":[],"mappings":"AAAA,0BAA0B;AAC1B,oCAAoC;AACpC,8DAA8D;AAE9D,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,MAAM,CAAC;AAOxC,mCAAmC;AACnC,MAAM,UAAU,mBAAmB,CAAC,KAAsB;IACxD,MAAM,EAAE,MAAM,EAAE,gBAAgB,EAAE,GAAG,KAAK,CAAC;IAC3C,MAAM,UAAU,GACd,MAAM,KAAK,UAAU;QACnB,CAAC,CAAC,qDAAqD;QACvD,CAAC,CAAC,wDAAwD,CAAC;IAE/D,OAAO;;;SAGA,MAAM;IACX,UAAU;;;QAGN,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;;;;CAIlC,CAAC,IAAI,EAAE,CAAC;AACT,CAAC;AAUD,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,SAAiB,EAAE,EAAU;IACvD,OAAO,IAAI,CAAC,SAAS,EAAE,YAAY,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC;AAC7D,CAAC;AAED,sBAAsB;AACtB,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,SAAiB,EACjB,EAAU,EACV,KAAsB;IAEtB,MAAM,IAAI,GAAmB;QAC3B,MAAM,EAAE,sBAAsB;QAC9B,EAAE;QACF,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,kBAAkB,EAAE,KAAK,CAAC,gBAAgB;QAC1C,eAAe,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC1C,CAAC;IACF,MAAM,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,SAAS,CAAC,IAAI,CAAC,EAAE;QAC3D,QAAQ,EAAE,MAAM;QAChB,IAAI,EAAE,KAAK;KACZ,CAAC,CAAC;AACL,CAAC;AAOD,yBAAyB;AACzB,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB,EAAE,EAAU;IACjE,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACxC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IACnE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAA0B,CAAC;QAChD,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,MAAM,KAAK,sBAAsB,EAAE,CAAC;YAClD,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;QAC9C,CAAC;QACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;IAC9C,CAAC;AACH,CAAC"}

package/dist/core/migrate/archive-detect.d.ts

@@ -0,0 +1,19 @@
+export interface DetectArchiveInput {
+    slug: string;
+    planContent: string;
+    gitLogCommits: string[];
+    mtimeAgeDays: number;
+    hasArchivedMarker: boolean;
+    inGitRepo: boolean;
+}
+export interface DetectArchiveResult {
+    recommended: 'active' | 'archive';
+    reasons: string[];
+}
+export declare function parseCheckboxes(content: string): {
+    total: number;
+    checked: number;
+};
+export declare function countSlugInGitLog(commits: string[], slug: string): number;
+export declare function detectArchive(input: DetectArchiveInput): DetectArchiveResult;
+//# sourceMappingURL=archive-detect.d.ts.map

package/dist/core/migrate/archive-detect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"archive-detect.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/archive-detect.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IAEb,WAAW,EAAE,MAAM,CAAC;IAEpB,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,YAAY,EAAE,MAAM,CAAC;IAErB,iBAAiB,EAAE,OAAO,CAAC;IAE3B,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,QAAQ,GAAG,SAAS,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAGD,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAUnF;AAGD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQzE;AAoBD,wBAAgB,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB,CA0C5E"}

package/dist/core/migrate/archive-detect.js

@@ -0,0 +1,89 @@
+// 已归档推测引擎 — Plan 8c Task 3.1
+// Spec §2.2:信号 1 checkbox ≥ 95% 且 task ≥ 3 / 信号 2 git log word-boundary + slug / 信号 3 mtime 仅展示 / 信号 4 marker
+// 信号 1:解析 checkbox total + checked
+export function parseCheckboxes(content) {
+    let total = 0;
+    let checked = 0;
+    for (const line of content.split('\n')) {
+        const m = line.match(/^\s*- \[([ x])\]/);
+        if (!m)
+            continue;
+        total++;
+        if (m[1] === 'x')
+            checked++;
+    }
+    return { total, checked };
+}
+// 信号 2:git log word-boundary close 关键词 + slug 共同命中
+export function countSlugInGitLog(commits, slug) {
+    const KEYWORDS = /\b(close|complete|done|finish|archive|ship|closing|closed)\b/i;
+    let count = 0;
+    for (const c of commits) {
+        if (!c.includes(slug))
+            continue;
+        if (KEYWORDS.test(c))
+            count++;
+    }
+    return count;
+}
+// 信号 4:critical-task-pending 检查(<!-- critical: task-N --> 标记的 task 未勾 [x])
+function hasCriticalTaskPending(content) {
+    const lines = content.split('\n');
+    // 找所有 <!-- critical: <task-id> --> 标记
+    const criticalIds = [];
+    for (const line of lines) {
+        const m = line.match(/<!--\s*critical:\s*([\w-]+)\s*-->/);
+        if (m && m[1])
+            criticalIds.push(m[1]);
+    }
+    if (criticalIds.length === 0)
+        return false;
+    // 检查这些 task-id 是否都勾 [x]
+    for (const id of criticalIds) {
+        const re = new RegExp(`- \\[x\\]\\s+${id}\\b`);
+        if (!re.test(content))
+            return true; // 有未勾 critical → pending
+    }
+    return false;
+}
+export function detectArchive(input) {
+    const reasons = [];
+    const { slug, planContent, gitLogCommits, mtimeAgeDays, hasArchivedMarker, inGitRepo } = input;
+    // 信号 4 marker — 优先级最高
+    if (hasArchivedMarker) {
+        reasons.push('marker: <!-- forge:archived -->');
+        return { recommended: 'archive', reasons };
+    }
+    // critical-task-pending 检查 — 即使 95% 也不 archive
+    if (hasCriticalTaskPending(planContent)) {
+        reasons.push('critical-task-pending(忽略其他信号)');
+        return { recommended: 'active', reasons };
+    }
+    // 信号 1 checkbox(必须 ≥ 3 task)
+    const { total, checked } = parseCheckboxes(planContent);
+    const sig1 = total >= 3 && checked / total >= 0.95
+        ? `checkbox ${checked}/${total} (${((checked / total) * 100).toFixed(0)}%)`
+        : null;
+    if (sig1)
+        reasons.push(sig1);
+    // 信号 2 git log
+    let sig2 = null;
+    if (inGitRepo) {
+        const closeCommits = countSlugInGitLog(gitLogCommits, slug);
+        if (closeCommits > 0)
+            sig2 = `git: ${closeCommits} close-commit(s) with slug`;
+        if (sig2)
+            reasons.push(sig2);
+    }
+    else {
+        reasons.push('git: not-available');
+    }
+    // 信号 3 mtime — 仅展示
+    reasons.push(`mtime: ${mtimeAgeDays}d ago`);
+    // 推荐:信号 1 OR 信号 2 命中 → archive
+    if (sig1 || sig2) {
+        return { recommended: 'archive', reasons };
+    }
+    return { recommended: 'active', reasons };
+}
+//# sourceMappingURL=archive-detect.js.map

package/dist/core/migrate/archive-detect.js.map

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

package/dist/core/migrate/budget.d.ts

@@ -0,0 +1,7 @@
+import type { MissingArtifact } from './types.js';
+export declare const MIGRATE_WARN_USD = 5;
+export type MissingArtifactWithLength = MissingArtifact & {
+    sourceLength: number;
+};
+export declare function estimateMigrateCost(missing: MissingArtifactWithLength[]): number;
+//# sourceMappingURL=budget.d.ts.map

package/dist/core/migrate/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/budget.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlD,eAAO,MAAM,gBAAgB,IAAI,CAAC;AAUlC,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,CAAC;AAGnF,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAYhF"}

package/dist/core/migrate/budget.js

@@ -0,0 +1,25 @@
+// src/core/migrate/budget.ts
+// migrate 专属 cost 估算 — Plan 8e Task 5.2
+// Spec §2.8 步骤 2 + §5.2 budget.ts(按件长度 + token,不用 brownfield 4-role 估算法)
+// $5 USD 警告阈值(spec §1.4 独立常量;不与 brownfield BUDGET_WARN 混)
+export const MIGRATE_WARN_USD = 5;
+// 估算公式参数(spec §2.8 步骤 2;I1 修:对齐 plan 参数,原版偏高 2-3 倍误触 MIGRATE_WARN_USD)
+const APPROX_INPUT_TOKEN_PER_BYTE = 0.25; // ~4 char/token(plan 参数)
+const APPROX_OUTPUT_TOKEN_FACTOR = 0.6; // output 是 input 的 60%(plan 参数)
+const SONNET_INPUT_PER_MTOK = 3; // $3 / Mtok
+const SONNET_OUTPUT_PER_MTOK = 15; // $15 / Mtok
+const FACTS_OVERHEAD_TOKENS = 2000; // extractFacts + judgeAll 的额外 token(plan 参数)
+// 估算 migrate --regenerate 的 LLM 调用成本(USD)
+export function estimateMigrateCost(missing) {
+    let totalCost = 0;
+    for (const m of missing) {
+        const inputTokens = m.sourceLength * APPROX_INPUT_TOKEN_PER_BYTE + FACTS_OVERHEAD_TOKENS;
+        const outputTokens = inputTokens * APPROX_OUTPUT_TOKEN_FACTOR;
+        const cost = (inputTokens / 1_000_000) * SONNET_INPUT_PER_MTOK +
+            (outputTokens / 1_000_000) * SONNET_OUTPUT_PER_MTOK;
+        totalCost += cost;
+    }
+    // 2 位小数(避免浮点尾巴)
+    return Math.round(totalCost * 100) / 100;
+}
+//# sourceMappingURL=budget.js.map

package/dist/core/migrate/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../../src/core/migrate/budget.ts"],"names":[],"mappings":"AAAA,6BAA6B;AAC7B,wCAAwC;AACxC,yEAAyE;AAIzE,0DAA0D;AAC1D,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,CAAC;AAElC,uEAAuE;AACvE,MAAM,2BAA2B,GAAG,IAAI,CAAC,CAAC,yBAAyB;AACnE,MAAM,0BAA0B,GAAG,GAAG,CAAC,CAAC,gCAAgC;AACxE,MAAM,qBAAqB,GAAG,CAAC,CAAC,CAAC,YAAY;AAC7C,MAAM,sBAAsB,GAAG,EAAE,CAAC,CAAC,aAAa;AAChD,MAAM,qBAAqB,GAAG,IAAI,CAAC,CAAC,6CAA6C;AAKjF,0CAA0C;AAC1C,MAAM,UAAU,mBAAmB,CAAC,OAAoC;IACtE,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,MAAM,WAAW,GAAG,CAAC,CAAC,YAAY,GAAG,2BAA2B,GAAG,qBAAqB,CAAC;QACzF,MAAM,YAAY,GAAG,WAAW,GAAG,0BAA0B,CAAC;QAC9D,MAAM,IAAI,GACR,CAAC,WAAW,GAAG,SAAS,CAAC,GAAG,qBAAqB;YACjD,CAAC,YAAY,GAAG,SAAS,CAAC,GAAG,sBAAsB,CAAC;QACtD,SAAS,IAAI,IAAI,CAAC;IACpB,CAAC;IACD,gBAAgB;IAChB,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AAC3C,CAAC"}

package/dist/core/migrate/conflict.d.ts

@@ -0,0 +1,49 @@
+import type { CopyOp } from './types.js';
+export declare class ConflictExhausted extends Error {
+    readonly target: string;
+    constructor(target: string);
+}
+export interface ResolveConflictsOptions {
+    /** --force 模式:旧目标 mv 到 trash */
+    force: boolean;
+    /** --force 时必填:用于 trash 路径计算 */
+    forgeRoot?: string;
+    /** trash 时间戳;不传默认 ISO now() */
+    ts?: string;
+}
+export interface ConflictResult {
+    /** 重写过的 op(target 可能改名) */
+    ops: CopyOp[];
+    /** 改名记录(原 target → 新 target) */
+    conflicts: Array<{
+        original: string;
+        renamed: string;
+    }>;
+    /** trash 记录(--force 模式) */
+    trashEntries: Array<{
+        original: string;
+        trashed: string;
+    }>;
+}
+/**
+ * plan 阶段全锁定:扫所有 op,目标存在则递增 --imported-N 直到唯一;
+ * --force 则旧目标先 mv 到 .forge-trash/<ts>/。
+ *
+ * reservedTargets 防同 plan 内多 op 抢同 imported-N slot。
+ */
+export declare function resolveConflicts(ops: CopyOp[], opts: ResolveConflictsOptions): Promise<ConflictResult>;
+/**
+ * 找到第一个可用的 --imported-N 路径;target 末级目录加 --imported-N 后缀。
+ *
+ * 示例:
+ *   /forge/changes/add-bar/proposal.md(N=1)
+ *   → /forge/changes/add-bar--imported/proposal.md
+ *   → /forge/changes/add-bar--imported-2/proposal.md(N=2)
+ *
+ * 撞至 maxImported → throw ConflictExhausted。
+ *
+ * export 用于测试:传入小 maxImported(如 2)可快速触发 ConflictExhausted 而无需 mkdir 99 次。
+ * resolveConflicts 内部调用时使用默认值 DEFAULT_MAX_IMPORTED(=99),行为不变。
+ */
+export declare function findFreeImportedSlot(target: string, reserved: Set<string>, maxImported?: number): string;
+//# sourceMappingURL=conflict.d.ts.map

package/dist/core/migrate/conflict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/conflict.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC,qBAAa,iBAAkB,SAAQ,KAAK;aACd,MAAM,EAAE,MAAM;gBAAd,MAAM,EAAE,MAAM;CAI3C;AAED,MAAM,WAAW,uBAAuB;IACtC,gCAAgC;IAChC,KAAK,EAAE,OAAO,CAAC;IACf,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B;IAC/B,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,cAAc;IAC7B,2BAA2B;IAC3B,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,gCAAgC;IAChC,SAAS,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACxD,2BAA2B;IAC3B,YAAY,EAAE,KAAK,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC5D;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EAAE,EACb,IAAI,EAAE,uBAAuB,GAC5B,OAAO,CAAC,cAAc,CAAC,CA8CzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,EACrB,WAAW,SAAuB,GACjC,MAAM,CAoBR"}

package/dist/core/migrate/conflict.js

@@ -0,0 +1,99 @@
+// src/core/migrate/conflict.ts
+// conflict 处理 — Plan 8d Task 4.1
+// Spec §2.4 冲突表:同名 --imported-N(撞 99 abort);--force trash 路径
+import { existsSync } from 'node:fs';
+import { mkdir, rename } from 'node:fs/promises';
+import { join, dirname, basename } from 'node:path';
+// 上限 99(spec §2.4):撞至 --imported-99 全占即 abort
+const DEFAULT_MAX_IMPORTED = 99;
+// --imported-N 全占时 throw
+export class ConflictExhausted extends Error {
+    target;
+    constructor(target) {
+        super(`--imported-1..${DEFAULT_MAX_IMPORTED} 全占;无法分配新名:${target}`);
+        this.target = target;
+        this.name = 'ConflictExhausted';
+    }
+}
+/**
+ * plan 阶段全锁定:扫所有 op,目标存在则递增 --imported-N 直到唯一;
+ * --force 则旧目标先 mv 到 .forge-trash/<ts>/。
+ *
+ * reservedTargets 防同 plan 内多 op 抢同 imported-N slot。
+ */
+export async function resolveConflicts(ops, opts) {
+    const conflicts = [];
+    const trashEntries = [];
+    // 同 plan 内已分配的 target 集合(防重)
+    const reservedTargets = new Set();
+    const newOps = [];
+    // ts 用作 trash 子目录名;: 在 windows 文件名非法,统一替换
+    const ts = opts.ts ?? new Date().toISOString().replace(/[:.]/g, '-');
+    for (const op of ops) {
+        const conflictOnDisk = existsSync(op.target);
+        const conflictReserved = reservedTargets.has(op.target);
+        if (!conflictOnDisk && !conflictReserved) {
+            // 目标无冲突:直接加入并 reserve
+            reservedTargets.add(op.target);
+            newOps.push(op);
+            continue;
+        }
+        if (opts.force && conflictOnDisk) {
+            // --force 模式:旧目标 mv 到 trash,目标路径不变
+            // reserved 冲突不算 force 命中(同 plan 内前后 op 互撞)
+            if (!opts.forgeRoot) {
+                throw new Error('--force 需要 forgeRoot 参数');
+            }
+            const trashRoot = join(opts.forgeRoot, '.forge-trash', ts);
+            await mkdir(trashRoot, { recursive: true });
+            const trashed = join(trashRoot, basename(op.target));
+            await rename(op.target, trashed);
+            trashEntries.push({ original: op.target, trashed });
+            reservedTargets.add(op.target);
+            newOps.push(op);
+            continue;
+        }
+        // 非 --force 或 reserved 冲突:递增 --imported-N 找空位(用默认 MAX=99)
+        const newTarget = findFreeImportedSlot(op.target, reservedTargets);
+        reservedTargets.add(newTarget);
+        conflicts.push({ original: op.target, renamed: newTarget });
+        // 记录 renamedFrom 以供 report 使用
+        newOps.push({ ...op, target: newTarget, renamedFrom: op.target });
+    }
+    return { ops: newOps, conflicts, trashEntries };
+}
+/**
+ * 找到第一个可用的 --imported-N 路径;target 末级目录加 --imported-N 后缀。
+ *
+ * 示例:
+ *   /forge/changes/add-bar/proposal.md(N=1)
+ *   → /forge/changes/add-bar--imported/proposal.md
+ *   → /forge/changes/add-bar--imported-2/proposal.md(N=2)
+ *
+ * 撞至 maxImported → throw ConflictExhausted。
+ *
+ * export 用于测试:传入小 maxImported(如 2)可快速触发 ConflictExhausted 而无需 mkdir 99 次。
+ * resolveConflicts 内部调用时使用默认值 DEFAULT_MAX_IMPORTED(=99),行为不变。
+ */
+export function findFreeImportedSlot(target, reserved, maxImported = DEFAULT_MAX_IMPORTED) {
+    const dir = dirname(target);
+    const file = basename(target);
+    // 兼容 unix(/) 和 windows(\) 两种分隔符
+    const dirParts = dir.split(/[\\/]/);
+    const lastDir = dirParts[dirParts.length - 1];
+    if (!lastDir)
+        throw new Error(`unexpected target without parent dir: ${target}`);
+    for (let n = 1; n <= maxImported; n++) {
+        // n=1 用 '--imported',n>=2 用 '--imported-N'
+        const suffix = n === 1 ? '--imported' : `--imported-${n}`;
+        // 重组:去除末段,加上末段+suffix,再 native join + file
+        // join() 会 normalize,保证 windows 下反斜杠一致
+        const newDir = [...dirParts.slice(0, -1), lastDir + suffix].join('/');
+        const candidate = join(newDir, file);
+        if (!existsSync(candidate) && !reserved.has(candidate)) {
+            return candidate;
+        }
+    }
+    throw new ConflictExhausted(target);
+}
+//# sourceMappingURL=conflict.js.map

package/dist/core/migrate/conflict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict.js","sourceRoot":"","sources":["../../../src/core/migrate/conflict.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,iCAAiC;AACjC,6DAA6D;AAE7D,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGpD,8CAA8C;AAC9C,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAEhC,yBAAyB;AACzB,MAAM,OAAO,iBAAkB,SAAQ,KAAK;IACd;IAA5B,YAA4B,MAAc;QACxC,KAAK,CAAC,iBAAiB,oBAAoB,cAAc,MAAM,EAAE,CAAC,CAAC;QADzC,WAAM,GAAN,MAAM,CAAQ;QAExC,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAoBD;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,GAAa,EACb,IAA6B;IAE7B,MAAM,SAAS,GAAgC,EAAE,CAAC;IAClD,MAAM,YAAY,GAAmC,EAAE,CAAC;IACxD,6BAA6B;IAC7B,MAAM,eAAe,GAAG,IAAI,GAAG,EAAU,CAAC;IAC1C,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,0CAA0C;IAC1C,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAErE,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,cAAc,GAAG,UAAU,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAC7C,MAAM,gBAAgB,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;QAExD,IAAI,CAAC,cAAc,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACzC,sBAAsB;YACtB,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,KAAK,IAAI,cAAc,EAAE,CAAC;YACjC,mCAAmC;YACnC,2CAA2C;YAC3C,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;gBACpB,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAC;YAC7C,CAAC;YACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CAAC,CAAC;YAC3D,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC;YACrD,MAAM,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;YACjC,YAAY,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;YACpD,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YAC/B,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YAChB,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,MAAM,SAAS,GAAG,oBAAoB,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QACnE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC/B,SAAS,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;QAC5D,8BAA8B;QAC9B,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC;IACpE,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAClD,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,oBAAoB,CAClC,MAAc,EACd,QAAqB,EACrB,WAAW,GAAG,oBAAoB;IAElC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5B,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9B,gCAAgC;IAChC,MAAM,QAAQ,GAAG,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC9C,IAAI,CAAC,OAAO;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,MAAM,EAAE,CAAC,CAAC;IAEjF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,2CAA2C;QAC3C,MAAM,MAAM,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,cAAc,CAAC,EAAE,CAAC;QAC1D,2CAA2C;QAC3C,uCAAuC;QACvC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACtE,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QACrC,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;YACvD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,MAAM,IAAI,iBAAiB,CAAC,MAAM,CAAC,CAAC;AACtC,CAAC"}

package/dist/core/migrate/index.d.ts

@@ -0,0 +1,7 @@
+import { getSource } from './sources/index.js';
+import type { MigrateOptions } from './types.js';
+export { getSource };
+export type { MigrateOptions, MigrateSource, SourceId } from './types.js';
+/** runMigrate 主流程编排 */
+export declare function runMigrate(opts: MigrateOptions): Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/core/migrate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/migrate/index.ts"],"names":[],"mappings":"AAYA,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAM/C,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,SAAS,EAAE,CAAC;AACrB,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE1E,uBAAuB;AACvB,wBAAsB,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkStE"}