tanmi-dock 1.0.3 → 1.0.4

package/dist/core/space/calibration-executor.js

@@ -0,0 +1,142 @@
+import { debug, info } from '../../utils/logger.js';
+import { buildCleanupPlan } from './cleanup-planner.js';
+import { buildCalibrationPlan, calibrationPlanSignature } from './calibration-planner.js';
+import { buildStoreSpaceSnapshot, revalidateUnregisteredPlatform } from './inventory.js';
+import { CleanupExecutor } from './cleanup-executor.js';
+function applyMetadataActions(draft, plan) {
+    for (const action of plan.actions) {
+        if (action.kind === 'refresh-size') {
+            const entry = draft.stores[action.storeKey];
+            if (!entry || entry.size !== action.previousBytes) {
+                throw new Error(`登记容量在校准期间发生变化: ${action.storeKey}`);
+            }
+            entry.size = action.measuredBytes;
+            continue;
+        }
+        if (action.kind === 'remove-missing-record') {
+            for (const storeKey of action.storeKeys)
+                delete draft.stores[storeKey];
+            if (action.libraryKey)
+                delete draft.libraries[action.libraryKey];
+            continue;
+        }
+        draft.stores[action.canonicalStoreKey] = structuredClone(action.mergedEntry);
+        for (const storeKey of action.removedStoreKeys)
+            delete draft.stores[storeKey];
+        const libraryKey = `${action.mergedEntry.libName}:${action.mergedEntry.commit}`;
+        const library = draft.libraries[libraryKey];
+        if (library) {
+            const prefix = `${libraryKey}:`;
+            const platforms = Object.keys(draft.stores)
+                .filter((key) => key.startsWith(prefix))
+                .map((key) => key.slice(prefix.length))
+                .filter((platform) => platform !== '_shared');
+            library.isGeneral = action.mergedEntry.platform === 'general';
+            library.platforms = [...new Set(platforms)].sort();
+        }
+    }
+}
+function buildUnregisteredSelections(plan) {
+    const grouped = new Map();
+    for (const target of plan.unregistered.targets) {
+        if (target.referenceStatus !== 'unreferenced')
+            continue;
+        const key = JSON.stringify([target.id.libName, target.id.commit]);
+        const existing = grouped.get(key);
+        if (existing && existing.platforms !== 'all') {
+            existing.platforms.push(target.platform);
+            continue;
+        }
+        grouped.set(key, { id: target.id, platforms: [target.platform] });
+    }
+    return [...grouped.values()];
+}
+async function validateUnregisteredGroup(registry, storePath, group) {
+    if (group.deleteKind !== 'platform' || !group.platform || !group.targetPath) {
+        throw new Error('校准未登记内容只能按明确的平台目录删除');
+    }
+    const segment = await revalidateUnregisteredPlatform(registry, storePath, group.id, group.platform);
+    const samePath = segment?.physicalPath === group.targetPath;
+    const sameCapacity = segment?.measured?.bytes === group.expectedRelease.bytes;
+    const confirmedUnreferenced = segment?.state === 'unregistered' &&
+        segment.referenceStatus === 'unreferenced' &&
+        segment.projectRefs.length === 0 &&
+        segment.referenceWarnings.length === 0;
+    debug(`[space] 校准删除前验证: lib=${group.id.libName}, commit=${group.id.commit}, platform=${group.platform}, target=${group.targetPath}, state=${segment?.state ?? 'missing'}, reference=${segment?.referenceStatus ?? 'unknown'}, projects=${segment?.projectRefs.join(',') || 'none'}, warnings=${segment?.referenceWarnings.join(' | ') || 'none'}, measured=${segment?.measured?.bytes ?? 'unknown'}, expected=${group.expectedRelease.bytes}, samePath=${samePath}, sameCapacity=${sameCapacity}`);
+    if (!samePath || !sameCapacity || !confirmedUnreferenced) {
+        throw new Error(`未登记平台在删除前发生变化，已保留: ${group.id.libName}/${group.id.commit}/${group.platform}`);
+    }
+}
+export class CalibrationExecutor {
+    registry;
+    storePath;
+    cleanupExecutor;
+    constructor(registry, storePath, cleanupExecutor = new CleanupExecutor(registry, storePath)) {
+        this.registry = registry;
+        this.storePath = storePath;
+        this.cleanupExecutor = cleanupExecutor;
+    }
+    /**
+     * 调用方必须持有全局锁。执行前重新审计，任何目录、容量或引用变化都会使原计划失效。
+     */
+    async execute(plan, options) {
+        debug(`[space] 校准执行开始: plan=${plan.id}, snapshot=${plan.snapshotId}, metadataActions=${plan.actions.length}, unregisteredChoice=${options.deleteUnregistered ? 'delete-unreferenced' : 'keep'}`);
+        const currentSnapshot = await buildStoreSpaceSnapshot(this.registry, this.storePath, {
+            mode: 'audit',
+        });
+        const currentPlan = buildCalibrationPlan(currentSnapshot);
+        if (calibrationPlanSignature(currentPlan) !== calibrationPlanSignature(plan)) {
+            debug(`[space] 校准计划失效: plan=${plan.id}, originalSnapshot=${plan.snapshotId}, currentSnapshot=${currentSnapshot.id}`);
+            throw new Error('扫描后 Store 目录、容量或项目引用发生变化，请重新运行 td calibrate');
+        }
+        for (const action of currentPlan.actions) {
+            if (action.kind === 'refresh-size') {
+                debug(`[space] 校准登记容量: key=${action.storeKey}, previous=${action.previousBytes}, measured=${action.measuredBytes}`);
+            }
+            else if (action.kind === 'remove-missing-record') {
+                debug(`[space] 校准缺失登记: keys=${action.storeKeys.join(',')}, registered=${action.registeredBytes}, libraryKey=${action.libraryKey ?? 'keep'}`);
+            }
+            else {
+                debug(`[space] 校准重复共享: canonical=${action.canonicalStoreKey}, removed=${action.removedStoreKeys.join(',') || 'none'}, projects=${action.mergedEntry.usedBy.join(',') || 'none'}, measured=${action.mergedEntry.size}`);
+            }
+        }
+        if (currentPlan.actions.length > 0) {
+            try {
+                await this.registry.mutateAtomically((draft) => applyMetadataActions(draft, currentPlan));
+                debug(`[space] 校准登记保存完成: plan=${plan.id}, actions=${currentPlan.actions.length}`);
+            }
+            catch (err) {
+                debug(`[space] 校准登记保存失败: plan=${plan.id}, actions=${currentPlan.actions.length}, error=${err.message}`);
+                throw err;
+            }
+        }
+        let cleanup;
+        if (options.deleteUnregistered) {
+            const selections = buildUnregisteredSelections(currentPlan);
+            if (selections.length > 0) {
+                const cleanupPlan = buildCleanupPlan({
+                    reason: 'repair',
+                    selections,
+                    requireUnreferenced: true,
+                    preservePlatformBoundaries: true,
+                }, currentSnapshot);
+                debug(`[space] 校准未登记平台清理计划: calibrationPlan=${plan.id}, cleanupPlan=${cleanupPlan.id}, targets=${cleanupPlan.groups.length}, expected=${cleanupPlan.expectedRelease.bytes}`);
+                cleanup = await this.cleanupExecutor.execute(cleanupPlan, {
+                    validateGroup: (group) => validateUnregisteredGroup(this.registry, this.storePath, group),
+                });
+                info(`[space] 校准未登记平台清理完成: plan=${cleanupPlan.id}, status=${cleanup.status}, succeeded=${cleanup.succeeded.length}, failed=${cleanup.failed.length}, released=${cleanup.released.bytes}`);
+            }
+        }
+        const finalSnapshot = await buildStoreSpaceSnapshot(this.registry, this.storePath, {
+            mode: 'audit',
+        });
+        debug(`[space] 校准执行完成: plan=${plan.id}, finalSnapshot=${finalSnapshot.id}, issues=${finalSnapshot.issues.length}, difference=${finalSnapshot.totals.differenceBytes}, metadataActions=${currentPlan.actions.length}, cleanupStatus=${cleanup?.status ?? 'skipped'}`);
+        return {
+            planId: plan.id,
+            metadataActionCount: currentPlan.actions.length,
+            cleanup,
+            finalSnapshot,
+        };
+    }
+}
+//# sourceMappingURL=calibration-executor.js.map

package/dist/core/space/calibration-executor.js.map

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

package/dist/core/space/calibration-planner.d.ts

@@ -0,0 +1,5 @@
+import type { SpaceCalibrationPlan, StoreSpaceSnapshot } from './types.js';
+export declare function buildCalibrationPlan(snapshot: StoreSpaceSnapshot): SpaceCalibrationPlan;
+/** 用于执行前确认目录、容量和引用状态没有在交互期间发生变化。 */
+export declare function calibrationPlanSignature(plan: SpaceCalibrationPlan): string;
+//# sourceMappingURL=calibration-planner.d.ts.map

package/dist/core/space/calibration-planner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibration-planner.d.ts","sourceRoot":"","sources":["../../../src/core/space/calibration-planner.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAIV,oBAAoB,EAGpB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAkHpB,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,GAAG,oBAAoB,CAqCvF;AAeD,oCAAoC;AACpC,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,oBAAoB,GAAG,MAAM,CAgB3E"}

package/dist/core/space/calibration-planner.js

@@ -0,0 +1,157 @@
+import crypto from 'crypto';
+import { GENERAL_PLATFORM, SHARED_PLATFORM } from '../platform.js';
+function storeKey(entry) {
+    return `${entry.libName}:${entry.commit}:${entry.platform}`;
+}
+function buildMergedSharedAction(commit, segment) {
+    const canonicalPlatform = commit.layout === 'platformed' ? SHARED_PLATFORM : GENERAL_PLATFORM;
+    const canonical = segment.entries.find((entry) => entry.platform === canonicalPlatform) ?? segment.entries[0];
+    const projectRefs = [
+        ...new Set([...segment.entries.flatMap((entry) => entry.usedBy), ...segment.projectRefs]),
+    ].sort();
+    const mergedEntry = {
+        ...canonical,
+        platform: canonicalPlatform,
+        size: segment.measured?.bytes ?? segment.registered?.bytes ?? canonical.size,
+        usedBy: projectRefs,
+        createdAt: segment.entries.map((entry) => entry.createdAt).sort()[0] ?? canonical.createdAt,
+        lastAccess: segment.entries
+            .map((entry) => entry.lastAccess)
+            .sort()
+            .at(-1) ?? canonical.lastAccess,
+    };
+    if (projectRefs.length > 0)
+        delete mergedEntry.unlinkedAt;
+    else {
+        const latestUnlinkedAt = Math.max(...segment.entries.map((entry) => entry.unlinkedAt ?? 0));
+        if (latestUnlinkedAt > 0)
+            mergedEntry.unlinkedAt = latestUnlinkedAt;
+    }
+    const canonicalStoreKey = `${commit.id.libName}:${commit.id.commit}:${canonicalPlatform}`;
+    return {
+        kind: 'merge-duplicate-shared',
+        canonicalStoreKey,
+        removedStoreKeys: segment.entries
+            .map(storeKey)
+            .filter((key) => key !== canonicalStoreKey)
+            .sort(),
+        mergedEntry,
+    };
+}
+function buildCommitActions(commit) {
+    const actions = [];
+    const registeredSegments = commit.segments.filter((segment) => segment.registryKeys.length > 0);
+    const missingSegments = registeredSegments.filter((segment) => segment.state === 'missing');
+    const missingKeys = new Set(missingSegments.flatMap((segment) => segment.registryKeys));
+    const allRegisteredKeys = registeredSegments.flatMap((segment) => segment.registryKeys);
+    if (missingKeys.size > 0) {
+        actions.push({
+            kind: 'remove-missing-record',
+            storeKeys: [...missingKeys].sort(),
+            registeredBytes: missingSegments.reduce((total, segment) => total + segment.entries.reduce((sum, entry) => sum + entry.size, 0), 0),
+            ...(missingKeys.size === allRegisteredKeys.length && commit.libraryRecordPresent
+                ? { libraryKey: `${commit.id.libName}:${commit.id.commit}` }
+                : {}),
+        });
+    }
+    for (const segment of registeredSegments) {
+        if (segment.state === 'missing')
+            continue;
+        const isDuplicateShared = segment.kind === 'shared' && segment.entries.length > 1;
+        if (isDuplicateShared) {
+            actions.push(buildMergedSharedAction(commit, segment));
+            continue;
+        }
+        if (segment.state !== 'changed' || !segment.measured)
+            continue;
+        for (const entry of segment.entries) {
+            actions.push({
+                kind: 'refresh-size',
+                storeKey: storeKey(entry),
+                previousBytes: entry.size,
+                measuredBytes: segment.measured.bytes,
+            });
+        }
+    }
+    return actions;
+}
+function buildUnregisteredTargets(snapshot) {
+    return snapshot.commits
+        .flatMap((commit) => commit.segments
+        .filter((segment) => segment.kind === 'platform' &&
+        segment.state === 'unregistered' &&
+        segment.measured != null)
+        .map((segment) => ({
+        id: commit.id,
+        platform: segment.platform,
+        physicalPath: segment.physicalPath,
+        measured: segment.measured,
+        referenceStatus: segment.referenceStatus,
+        projectRefs: [...segment.projectRefs].sort(),
+        referenceWarnings: [...segment.referenceWarnings].sort(),
+    })))
+        .sort((a, b) => `${a.id.libName}\0${a.id.commit}\0${a.platform}`.localeCompare(`${b.id.libName}\0${b.id.commit}\0${b.platform}`));
+}
+export function buildCalibrationPlan(snapshot) {
+    if (snapshot.mode !== 'audit')
+        throw new Error('空间校准需要 audit 快照');
+    const actions = snapshot.commits.flatMap(buildCommitActions);
+    const targets = buildUnregisteredTargets(snapshot);
+    const deletable = targets.filter((target) => target.referenceStatus === 'unreferenced');
+    const refreshActions = actions.filter((action) => action.kind === 'refresh-size');
+    const missingActions = actions.filter((action) => action.kind === 'remove-missing-record');
+    const duplicateActions = actions.filter((action) => action.kind === 'merge-duplicate-shared');
+    return {
+        id: crypto.randomBytes(8).toString('hex'),
+        snapshotId: snapshot.id,
+        createdAt: Date.now(),
+        actions,
+        unregistered: {
+            targets,
+            totalCount: targets.length,
+            totalBytes: targets.reduce((sum, target) => sum + target.measured.bytes, 0),
+            deletableCount: deletable.length,
+            deletableBytes: deletable.reduce((sum, target) => sum + target.measured.bytes, 0),
+            protectedCount: targets.length - deletable.length,
+        },
+        summary: {
+            changedCount: refreshActions.length,
+            changedDifferenceBytes: refreshActions.reduce((sum, action) => sum + action.measuredBytes - action.previousBytes, 0),
+            missingCount: missingActions.reduce((sum, action) => sum + action.storeKeys.length, 0),
+            missingRegisteredBytes: missingActions.reduce((sum, action) => sum + action.registeredBytes, 0),
+            duplicateSharedCount: duplicateActions.length,
+            ignoredArtifactCount: snapshot.ignoredArtifacts.length,
+        },
+    };
+}
+function comparableAction(action) {
+    if (action.kind === 'merge-duplicate-shared') {
+        return {
+            ...action,
+            mergedEntry: {
+                ...action.mergedEntry,
+                usedBy: [...action.mergedEntry.usedBy].sort(),
+            },
+        };
+    }
+    return action;
+}
+/** 用于执行前确认目录、容量和引用状态没有在交互期间发生变化。 */
+export function calibrationPlanSignature(plan) {
+    return JSON.stringify({
+        actions: plan.actions.map(comparableAction),
+        unregistered: plan.unregistered.targets.map((target) => ({
+            id: target.id,
+            platform: target.platform,
+            physicalPath: target.physicalPath,
+            measuredBytes: target.measured.bytes,
+            measuredBasis: target.measured.basis,
+            measuredQuality: target.measured.quality,
+            referenceStatus: target.referenceStatus,
+            projectRefs: target.projectRefs,
+            referenceWarnings: target.referenceWarnings,
+        })),
+        ignoredArtifactCount: plan.summary.ignoredArtifactCount,
+    });
+}
+//# sourceMappingURL=calibration-planner.js.map

package/dist/core/space/calibration-planner.js.map

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

package/dist/core/space/cleanup-executor.d.ts

@@ -0,0 +1,15 @@
+import type RegistryManager from '../registry.js';
+import type { CleanupExecutionResult, CleanupExecutionOptions, CleanupPlan } from './types.js';
+export declare class CleanupExecutor {
+    private readonly registry;
+    private readonly storePath;
+    private readonly options;
+    constructor(registry: RegistryManager, storePath: string, options?: {
+        journalDir?: string;
+    });
+    private validateGroup;
+    private removeRegistryData;
+    execute(plan: CleanupPlan, executionOptions?: CleanupExecutionOptions): Promise<CleanupExecutionResult>;
+    recoverPending(): Promise<number>;
+}
+//# sourceMappingURL=cleanup-executor.d.ts.map

package/dist/core/space/cleanup-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-executor.d.ts","sourceRoot":"","sources":["../../../src/core/space/cleanup-executor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,eAAe,MAAM,gBAAgB,CAAC;AAKlD,OAAO,KAAK,EACV,sBAAsB,EACtB,uBAAuB,EAGvB,WAAW,EAEZ,MAAM,YAAY,CAAC;AAiDpB,qBAAa,eAAe;IAExB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,QAAQ,EAAE,eAAe,EACzB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAA;KAAO;YAG1C,aAAa;IAuB3B,OAAO,CAAC,kBAAkB;IAsBpB,OAAO,CACX,IAAI,EAAE,WAAW,EACjB,gBAAgB,CAAC,EAAE,uBAAuB,GACzC,OAAO,CAAC,sBAAsB,CAAC;IAuE5B,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;CAyCxC"}

package/dist/core/space/cleanup-executor.js

@@ -0,0 +1,188 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { debug, error, info, warn } from '../../utils/logger.js';
+import { CleanupJournal } from './cleanup-journal.js';
+import { isPathInsideStore, pathExists } from './meter.js';
+import { createSpaceAmount } from './types.js';
+function sumReleased(amounts) {
+    const bytes = amounts.reduce((sum, amount) => sum + amount.bytes, 0);
+    const quality = amounts.some((amount) => amount.quality === 'partial')
+        ? 'partial'
+        : amounts.some((amount) => amount.quality !== 'exact')
+            ? 'approximate'
+            : 'exact';
+    const basis = amounts.every((amount) => amount.basis === 'allocated') ? 'allocated' : 'logical';
+    return createSpaceAmount(bytes, basis, quality);
+}
+async function removeEmptyLibraryDirectory(storePath, libName) {
+    const libraryPath = path.join(storePath, libName);
+    try {
+        const remaining = await fs.readdir(libraryPath);
+        if (remaining.length === 0) {
+            await fs.rm(libraryPath, { recursive: true, force: true });
+        }
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== 'ENOENT') {
+            warn(`[space] 检查空库目录失败，已保留目录: path=${libraryPath}, error=${err.message}`);
+        }
+    }
+}
+async function removeEmptyCommitDirectory(storePath, libName, commit) {
+    const commitPath = path.join(storePath, libName, commit);
+    try {
+        const remaining = await fs.readdir(commitPath);
+        if (remaining.length === 0)
+            await fs.rm(commitPath, { recursive: true, force: true });
+    }
+    catch (err) {
+        const code = err.code;
+        if (code !== 'ENOENT') {
+            warn(`[space] 检查空版本目录失败，已保留目录: path=${commitPath}, error=${err.message}`);
+        }
+    }
+}
+export class CleanupExecutor {
+    registry;
+    storePath;
+    options;
+    constructor(registry, storePath, options = {}) {
+        this.registry = registry;
+        this.storePath = storePath;
+        this.options = options;
+    }
+    async validateGroup(plan, group, executionOptions) {
+        if (path.resolve(plan.storePath) !== path.resolve(this.storePath)) {
+            throw new Error(`清理计划的 Store 目录与当前配置不一致: ${plan.storePath}`);
+        }
+        if (group.targetPath && !isPathInsideStore(this.storePath, group.targetPath)) {
+            throw new Error(`拒绝删除 Store 目录外的目标: ${group.targetPath}`);
+        }
+        if (group.requireUnreferenced) {
+            const referenced = group.storeKeys.filter((key) => {
+                const entry = this.registry.getStore(key);
+                return entry && entry.usedBy.length > 0;
+            });
+            if (referenced.length > 0) {
+                throw new Error(`目标重新产生项目引用: ${referenced.join(', ')}`);
+            }
+        }
+        await executionOptions?.validateGroup?.(group);
+    }
+    removeRegistryData(group) {
+        const removedStoreKeys = [];
+        for (const key of group.storeKeys) {
+            if (this.registry.getStore(key)) {
+                this.registry.removeStore(key);
+                removedStoreKeys.push(key);
+            }
+        }
+        let removedLibraryKey;
+        if (group.libraryKey && this.registry.getLibrary(group.libraryKey)) {
+            this.registry.removeLibrary(group.libraryKey);
+            removedLibraryKey = group.libraryKey;
+        }
+        return {
+            id: group.id,
+            platform: group.platform,
+            released: group.expectedRelease,
+            removedStoreKeys,
+            removedLibraryKey,
+        };
+    }
+    async execute(plan, executionOptions) {
+        debug(`[space] 清理执行开始: plan=${plan.id}, reason=${plan.reason}, store=${plan.storePath}, groups=${plan.groups.length}, expected=${plan.expectedRelease.bytes}`);
+        const journal = await CleanupJournal.create(plan, this.options.journalDir);
+        const succeeded = [];
+        const failed = [];
+        for (let index = 0; index < plan.groups.length; index++) {
+            const group = plan.groups[index];
+            let filesRemoved = false;
+            try {
+                await this.validateGroup(plan, group, executionOptions);
+                await journal.updateGroup(index, 'deleting');
+                debug(`[space] 清理组状态: plan=${plan.id}, index=${index}, state=deleting, lib=${group.id.libName}, commit=${group.id.commit}, platform=${group.platform ?? 'all'}, target=${group.targetPath ?? 'registry-only'}`);
+                if (group.targetPath) {
+                    await fs.rm(group.targetPath, { recursive: true, force: true });
+                    const stillExists = await pathExists(group.targetPath);
+                    debug(`[space] 文件删除返回: plan=${plan.id}, index=${index}, target=${group.targetPath}, existsAfterDelete=${stillExists}`);
+                    if (stillExists) {
+                        throw new Error(`删除后目标仍然存在: ${group.targetPath}`);
+                    }
+                }
+                filesRemoved = true;
+                await journal.updateGroup(index, 'filesRemoved');
+                const result = this.removeRegistryData(group);
+                debug(`[space] 注册更新准备: plan=${plan.id}, index=${index}, removedStoreKeys=${result.removedStoreKeys.join(',') || 'none'}, removedLibraryKey=${result.removedLibraryKey ?? 'none'}`);
+                await this.registry.save();
+                debug(`[space] 注册保存完成: plan=${plan.id}, index=${index}, state=registrySaved`);
+                await journal.updateGroup(index, 'registrySaved');
+                await removeEmptyCommitDirectory(this.storePath, group.id.libName, group.id.commit);
+                await removeEmptyLibraryDirectory(this.storePath, group.id.libName);
+                succeeded.push(result);
+                info(`[space] 清理组完成: plan=${plan.id}, lib=${group.id.libName}, commit=${group.id.commit.slice(0, 8)}, platform=${group.platform ?? 'all'}, released=${group.expectedRelease.bytes}`);
+            }
+            catch (err) {
+                const message = err.message;
+                error(`[space] 清理组失败: plan=${plan.id}, index=${index}, state=${filesRemoved ? 'filesRemoved' : 'deleting'}, lib=${group.id.libName}, commit=${group.id.commit}, platform=${group.platform ?? 'all'}, error=${message}`);
+                if (filesRemoved) {
+                    // 文件已经删除，保留日志并停止，下一次由前向恢复补齐注册记录。
+                    throw err;
+                }
+                await journal.updateGroup(index, 'failed', message).catch(() => { });
+                failed.push({
+                    id: group.id,
+                    platform: group.platform,
+                    state: 'deleting',
+                    message,
+                });
+            }
+        }
+        await journal.complete();
+        const status = failed.length === 0 ? 'completed' : succeeded.length > 0 ? 'partial' : 'failed';
+        const released = sumReleased(succeeded.map((result) => result.released));
+        debug(`[space] 清理执行完成: plan=${plan.id}, status=${status}, succeeded=${succeeded.length}, failed=${failed.length}, released=${released.bytes}`);
+        return { planId: plan.id, status, released, succeeded, failed };
+    }
+    async recoverPending() {
+        const journals = await CleanupJournal.listPending(this.options.journalDir);
+        let recovered = 0;
+        for (const journal of journals) {
+            const data = journal.getData();
+            if (path.resolve(data.storePath) !== path.resolve(this.storePath)) {
+                warn(`[space] 跳过清理恢复: plan=${data.planId}, journalStore=${data.storePath}, currentStore=${this.storePath}`);
+                continue;
+            }
+            debug(`[space] 清理恢复开始: plan=${data.planId}, groups=${data.groups.length}`);
+            let canComplete = true;
+            for (const group of data.groups) {
+                if (group.targetPath && !isPathInsideStore(this.storePath, group.targetPath)) {
+                    error(`[space] 清理恢复目标越界: plan=${data.planId}, target=${group.targetPath}`);
+                    canComplete = false;
+                    break;
+                }
+                if (group.state === 'registrySaved' || group.state === 'failed')
+                    continue;
+                const targetStillExists = group.targetPath ? await pathExists(group.targetPath) : false;
+                if (targetStillExists) {
+                    await journal.updateGroup(group.index, 'failed', '恢复时目标目录仍存在，保留注册记录');
+                    warn(`[space] 清理恢复保留目标: plan=${data.planId}, target=${group.targetPath}, state=${group.state}`);
+                    continue;
+                }
+                for (const key of group.storeKeys)
+                    this.registry.removeStore(key);
+                if (group.libraryKey)
+                    this.registry.removeLibrary(group.libraryKey);
+                await this.registry.save();
+                await journal.updateGroup(group.index, 'registrySaved');
+                recovered++;
+                info(`[space] 清理恢复完成组: plan=${data.planId}, lib=${group.id.libName}, commit=${group.id.commit.slice(0, 8)}, platform=${group.platform ?? 'all'}`);
+            }
+            if (canComplete)
+                await journal.complete();
+        }
+        return recovered;
+    }
+}
+//# sourceMappingURL=cleanup-executor.js.map

package/dist/core/space/cleanup-executor.js.map

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

package/dist/core/space/cleanup-journal.d.ts

@@ -0,0 +1,43 @@
+import type { CleanupPlan } from './types.js';
+export type CleanupJournalGroupState = 'prepared' | 'deleting' | 'filesRemoved' | 'registrySaved' | 'failed';
+export interface CleanupJournalGroup {
+    index: number;
+    state: CleanupJournalGroupState;
+    id: {
+        libName: string;
+        commit: string;
+    };
+    platform?: string;
+    targetPath?: string;
+    storeKeys: string[];
+    libraryKey?: string;
+    error?: string;
+}
+export interface CleanupJournalData {
+    version: 1;
+    planId: string;
+    storePath: string;
+    reason: CleanupPlan['reason'];
+    createdAt: number;
+    groups: CleanupJournalGroup[];
+}
+export interface CleanupJournalInspection {
+    journals: CleanupJournal[];
+    corruptedFiles: string[];
+}
+export declare class CleanupJournal {
+    private data;
+    private readonly filePath;
+    private constructor();
+    /** 创建前向恢复日志。journalDir 仅用于隔离测试或受控运行环境。 */
+    static create(plan: CleanupPlan, journalDir?: string): Promise<CleanupJournal>;
+    /** 读取可恢复日志；损坏日志保留原文件，避免猜测删除状态。 */
+    static listPending(journalDir?: string): Promise<CleanupJournal[]>;
+    /** 同时返回可恢复日志和无法解析的日志文件。 */
+    static inspectPending(journalDir?: string): Promise<CleanupJournalInspection>;
+    getData(): CleanupJournalData;
+    updateGroup(index: number, state: CleanupJournalGroupState, error?: string): Promise<void>;
+    complete(): Promise<void>;
+    private save;
+}
+//# sourceMappingURL=cleanup-journal.d.ts.map

package/dist/core/space/cleanup-journal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-journal.d.ts","sourceRoot":"","sources":["../../../src/core/space/cleanup-journal.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,MAAM,wBAAwB,GAChC,UAAU,GACV,UAAU,GACV,cAAc,GACd,eAAe,GACf,QAAQ,CAAC;AAEb,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,wBAAwB,CAAC;IAChC,EAAE,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAUD,qBAAa,cAAc;IAEvB,OAAO,CAAC,IAAI;IACZ,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAF3B,OAAO;IAKP,0CAA0C;WAC7B,MAAM,CACjB,IAAI,EAAE,WAAW,EACjB,UAAU,GAAE,MAA+B,GAC1C,OAAO,CAAC,cAAc,CAAC;IAsB1B,kCAAkC;WACrB,WAAW,CAAC,UAAU,GAAE,MAA+B,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAIhG,2BAA2B;WACd,cAAc,CACzB,UAAU,GAAE,MAA+B,GAC1C,OAAO,CAAC,wBAAwB,CAAC;IA4BpC,OAAO,IAAI,kBAAkB;IAIvB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,wBAAwB,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1F,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;YAIjB,IAAI;CAGnB"}