tanmi-dock 0.10.0-beta → 1.0.4

package/README.md

@@ -70,14 +70,16 @@ td status
 | `td link` | 链接项目依赖 |
 | `td link -p mac ios` | 指定平台链接 |
 | `td status` | 查看当前项目状态 |
-| `td status -s` | 查看 Store 状态 |
 | `td projects` | 列出所有已链接项目 |
 | `td clean` | 清理无引用的库 |
+| `td calibrate` | 按 Store 实际状态校准空间登记 |
 | `td unlink` | 解除链接，恢复为目录 |
 | `td config` | 交互式配置 |
-| `td doctor` | 环境诊断 |
-| `td verify` | 完整性验证 |
-| `td repair` | 修复问题 |
+| `td check` | 环境诊断和数据一致性检查 |
+| `td check --fix` | 修复检查发现的问题 |
+| `td check --dry-run` | 只显示问题，不执行修复 |
+| `td reset <lib>` | 重置指定库的 Store 缓存和登记信息 |
+| `td unavailable` | 管理手动平台缺失规则 |
 | `td update` | 更新到最新版本 |
 | `td migrate <path>` | 迁移 Store 位置 |
 
@@ -134,6 +136,21 @@ td config set <key> <value>  # 设置配置
 | `capacity` | 无引用库超过阈值时提示清理 |
 | `manual` | 不自动清理 |
 
+### 空间数据含义
+
+- **实际占用**来自当前 Store 目录的磁盘测量。
+- **登记容量**来自 StoreEntry 最近一次记录，可能与当前磁盘存在差异。
+- **预计释放**在清理确认前按本次计划目标重新测量，包含同版本 `_shared`，且只计算一次。
+- **项目依赖容量**按项目实际引用的平台和共享内容去重计算。
+- **共享节省与下载容量**属于估算值；历史依据不足时显示容量未知。
+
+`td check --json` 可以查看测量依据、结果质量和磁盘与登记容量差异。
+
+当检查发现登记容量过期、目录缺失、重复共享登记或未登记平台时，运行
+`td calibrate` 统一处理。命令会更新容量、移除失效登记并合并重复共享记录；
+未登记平台只提供整体“暂不处理”或“删除无项目引用内容”两种选择，默认保留。
+`td calibrate --dry-run` 完全只读，`td calibrate --yes` 使用默认保留策略并跳过确认。
+
 ## 工作原理
 
 ```
@@ -156,7 +173,9 @@ td config set <key> <value>  # 设置配置
 
 `sharedSymlinkFolders` 默认值为 `true`。如需排查构建工具对符号链接目录的兼容性，可通过 `td config set sharedSymlinkFolders false` 临时切回复制模式。
 
-`gitLightweightDownload` 默认值为 `true`。开启后下载阶段优先使用 Git 非完整拉取，只获取指定平台和必要共享内容，可有效降低临时下载空间消耗。
+TanmiDock 会按 CodePac 配置规则解析 `repos`、`actions`、`vars`、平台分组、`name`、`source` 和 `dir`，并把主配置、可选配置、嵌套 action 配置同步到各自的 `.cache/<配置文件名>`。本地 Git 库优先通过 `.git/commit_hash` 判断 commit，和 CodePac 的完成标记保持一致。
+
+`gitLightweightDownload` 默认值为 `true`。开启后下载阶段优先使用 Git 非完整拉取，只获取指定平台和必要共享内容，并在成功后保留 CodePac minisize 所需的 `commit_hash` 标记，可有效降低临时下载空间消耗。关闭该配置只表示不使用 TanmiDock 的 Git 非完整拉取；CodePac 自身默认也会倾向 minisize 下载。
 
 ## 常见问题
 
@@ -186,6 +205,8 @@ td projects --tree           # 树状显示库引用关系
 td migrate /Volumes/Data/.tanmi-dock/store
 ```
 
+迁移要求目标目录为空。复制先进入专用暂存目录，保留符号链接并更新指向旧 Store 内部的绝对链接；验证通过后才切换配置和项目链接。进程中断后，再次运行 `td migrate` 会根据迁移日志继续执行。
+
 ## 更多文档
 
 - [CLI 完整文档](docs/CLI.md) - 所有命令的详细参数和示例

package/dist/commands/calibrate.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+interface CalibrateOptions {
+    dryRun: boolean;
+    yes: boolean;
+}
+/** 执行一次空间校准。非 dry-run 调用方必须持有全局锁。 */
+export declare function calibrateStore(options: CalibrateOptions): Promise<void>;
+export declare function createCalibrateCommand(): Command;
+export default createCalibrateCommand;
+//# sourceMappingURL=calibrate.d.ts.map

package/dist/commands/calibrate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calibrate.d.ts","sourceRoot":"","sources":["../../src/commands/calibrate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAsBpC,UAAU,gBAAgB;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,GAAG,EAAE,OAAO,CAAC;CACd;AAgED,qCAAqC;AACrC,wBAAsB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2F7E;AAED,wBAAgB,sBAAsB,IAAI,OAAO,CAehD;AAED,eAAe,sBAAsB,CAAC"}

package/dist/commands/calibrate.js

@@ -0,0 +1,158 @@
+import { Command } from 'commander';
+import { ensureInitialized } from '../core/guard.js';
+import * as config from '../core/config.js';
+import { getRegistry } from '../core/registry.js';
+import { SpaceService } from '../core/space/service.js';
+import { formatSize } from '../utils/disk.js';
+import { withGlobalLock } from '../utils/global-lock.js';
+import { blank, debug, error, hint, info, separator, success, title, verboseJson, warn, } from '../utils/logger.js';
+import { confirmAction, PROMPT_CANCELLED, selectOption } from '../utils/prompt.js';
+function formatSignedSize(bytes) {
+    const sign = bytes > 0 ? '+' : bytes < 0 ? '-' : '';
+    return `${sign}${formatSize(Math.abs(bytes))}`;
+}
+function renderPlan(plan, choice) {
+    title('空间校准检查:');
+    info(`  登记容量变化  ${plan.summary.changedCount} 项，合计 ${formatSignedSize(plan.summary.changedDifferenceBytes)}`);
+    info(`  目录缺失      ${plan.summary.missingCount} 项，登记容量 ${formatSize(plan.summary.missingRegisteredBytes)}`);
+    info(`  重复共享登记  ${plan.summary.duplicateSharedCount} 项`);
+    info(`  未登记平台    ${plan.unregistered.totalCount} 项，合计 ${formatSize(plan.unregistered.totalBytes)}`);
+    if (plan.unregistered.protectedCount > 0) {
+        info(`  引用保护      ${plan.unregistered.protectedCount} 项`);
+    }
+    info(`  系统文件      ${plan.summary.ignoredArtifactCount} 项，将忽略并保留`);
+    blank();
+    if (choice === 'delete-unreferenced') {
+        info(`未登记平台处理: 删除 ${plan.unregistered.deletableCount} 项无项目引用内容，预计释放 ${formatSize(plan.unregistered.deletableBytes)}`);
+    }
+    else {
+        info('未登记平台处理: 暂不处理');
+    }
+}
+function hasMetadataActions(plan) {
+    return plan.actions.length > 0;
+}
+async function chooseUnregisteredAction(plan, options) {
+    if (plan.unregistered.totalCount === 0 || options.dryRun || options.yes)
+        return 'keep';
+    blank();
+    const choice = await selectOption('未登记平台如何处理?', [
+        {
+            name: '暂不处理',
+            value: 'keep',
+            description: `保留全部 ${plan.unregistered.totalCount} 项内容`,
+        },
+        {
+            name: '删除无项目引用的内容',
+            value: 'delete-unreferenced',
+            description: `删除 ${plan.unregistered.deletableCount} 项，保留 ${plan.unregistered.protectedCount} 项`,
+        },
+    ]);
+    if (choice === PROMPT_CANCELLED) {
+        info('已取消校准');
+        return null;
+    }
+    return choice;
+}
+/** 执行一次空间校准。非 dry-run 调用方必须持有全局锁。 */
+export async function calibrateStore(options) {
+    debug(`[space] 校准命令输入: dryRun=${options.dryRun}, yes=${options.yes}, source=td-calibrate`);
+    const cfg = await config.load({ migrate: !options.dryRun });
+    if (!cfg)
+        throw new Error('配置文件不存在，请先运行 tanmi-dock init');
+    if (options.dryRun && config.checkConfigVersion(cfg) === 'migrate') {
+        throw new Error('配置需要迁移；dry-run 不会修改配置，请先运行一次普通命令完成迁移');
+    }
+    const registry = getRegistry();
+    await registry.load({ migrate: !options.dryRun });
+    const service = new SpaceService(registry, cfg.storePath);
+    const cleanupExecutor = service.createCleanupExecutor();
+    if (!options.dryRun) {
+        const recovered = await cleanupExecutor.recoverPending();
+        if (recovered > 0)
+            info(`恢复了 ${recovered} 个中断清理记录`);
+    }
+    else {
+        debug('[space] 校准 dry-run 跳过配置迁移、登记迁移、清理恢复和全局写锁');
+    }
+    info('扫描 Store 并核对登记数据...');
+    const snapshot = await service.buildSnapshot('audit');
+    const plan = service.buildCalibrationPlan(snapshot);
+    debug(`[space] 校准审计完成: plan=${plan.id}, snapshot=${snapshot.id}, changed=${plan.summary.changedCount}, changedDifference=${plan.summary.changedDifferenceBytes}, missing=${plan.summary.missingCount}, missingBytes=${plan.summary.missingRegisteredBytes}, duplicates=${plan.summary.duplicateSharedCount}, unregistered=${plan.unregistered.totalCount}, unregisteredBytes=${plan.unregistered.totalBytes}, deletable=${plan.unregistered.deletableCount}, protected=${plan.unregistered.protectedCount}, ignored=${plan.summary.ignoredArtifactCount}`);
+    verboseJson('[space] 校准计划 JSON', plan);
+    const choice = await chooseUnregisteredAction(plan, options);
+    if (!choice)
+        return;
+    blank();
+    renderPlan(plan, choice);
+    const willDelete = choice === 'delete-unreferenced' && plan.unregistered.deletableCount > 0;
+    if (!hasMetadataActions(plan) && !willDelete) {
+        if (plan.unregistered.totalCount > 0) {
+            success('登记数据无需调整，未登记平台按选择保留');
+        }
+        else {
+            success('空间登记与 Store 实际状态一致');
+        }
+        return;
+    }
+    if (options.dryRun) {
+        blank();
+        hint('dry-run 仅检查，不修改登记数据或 Store 内容');
+        return;
+    }
+    if (!options.yes) {
+        blank();
+        const confirmed = await confirmAction(`确认执行 ${plan.actions.length} 项登记校准${willDelete ? `并删除 ${plan.unregistered.deletableCount} 项未登记平台` : ''}?`, false);
+        if (confirmed === PROMPT_CANCELLED || !confirmed) {
+            info('已取消校准');
+            return;
+        }
+    }
+    blank();
+    separator();
+    info(`正在执行空间校准计划 ${plan.id}...`);
+    const result = await service.createCalibrationExecutor().execute(plan, {
+        deleteUnregistered: choice === 'delete-unreferenced',
+    });
+    const remainingPlan = service.buildCalibrationPlan(result.finalSnapshot);
+    blank();
+    const cleanupFailed = result.cleanup != null && result.cleanup.status !== 'completed';
+    if (cleanupFailed) {
+        warn(`空间校准部分完成: 更新 ${result.metadataActionCount} 项登记数据，未登记平台删除成功 ${result.cleanup.succeeded.length} 项、失败 ${result.cleanup.failed.length} 项`);
+    }
+    else {
+        success(`空间校准完成: 更新 ${result.metadataActionCount} 项登记数据`);
+    }
+    if (result.cleanup && !cleanupFailed) {
+        info(`未登记平台清理: 删除 ${result.cleanup.succeeded.length} 项，释放 ${formatSize(result.cleanup.released.bytes)}`);
+    }
+    if (remainingPlan.unregistered.totalCount > 0) {
+        info(`保留未登记平台: ${remainingPlan.unregistered.totalCount} 项`);
+    }
+    const remainingMetadataIssues = remainingPlan.actions.length;
+    if (remainingMetadataIssues > 0) {
+        warn(`重新检查仍发现 ${remainingMetadataIssues} 项登记差异，请查看详细日志`);
+    }
+    debug(`[space] 校准最终输出: plan=${plan.id}, finalSnapshot=${result.finalSnapshot.id}, remainingMetadata=${remainingMetadataIssues}, remainingUnregistered=${remainingPlan.unregistered.totalCount}, finalDifference=${result.finalSnapshot.totals.differenceBytes}`);
+}
+export function createCalibrateCommand() {
+    return new Command('calibrate')
+        .description('校准 Store 空间登记数据')
+        .option('--dry-run', '只检查并显示校准内容')
+        .option('--yes', '使用默认选项并跳过最终确认')
+        .action(async (options) => {
+        await ensureInitialized();
+        try {
+            if (options.dryRun)
+                await calibrateStore(options);
+            else
+                await withGlobalLock(() => calibrateStore(options));
+        }
+        catch (err) {
+            error(err.message);
+            process.exitCode = 1;
+        }
+    });
+}
+export default createCalibrateCommand;
+//# sourceMappingURL=calibrate.js.map

package/dist/commands/calibrate.js.map

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

package/dist/commands/check.d.ts

@@ -1,4 +1,28 @@
 import { Command } from 'commander';
+import type { CodepacEnvironmentCheck } from '../core/codepac.js';
+import type { SpaceIssue, StoreSpaceTotals } from '../core/space/types.js';
+interface EnvironmentCheck {
+    codepac: {
+        ok: boolean;
+        message: string;
+        details: CodepacEnvironmentCheck;
+    };
+    config: {
+        ok: boolean;
+        message: string;
+    };
+    store: {
+        ok: boolean;
+        path: string;
+        message: string;
+    };
+    disk: {
+        ok: boolean;
+        free: number;
+        warn: boolean;
+        message: string;
+    };
+}
 interface IntegrityIssue {
     invalidProjects: {
         hash: string;
@@ -33,7 +57,7 @@ interface IntegrityIssue {
         commit: string;
         platform: string;
         reason: string;
-        kind?: 'integrity_mismatch' | 'shared_platform_conflict';
+        kind?: 'integrity_mismatch' | 'shared_platform_conflict' | 'missing_integrity_record';
         conflictPlatforms?: string[];
         expected: {
             fileCount?: number;
@@ -47,11 +71,31 @@ interface IntegrityIssue {
         };
     }[];
 }
+interface CheckResult {
+    environment: EnvironmentCheck;
+    integrity: IntegrityIssue;
+    space: {
+        snapshotId?: string;
+        totals?: StoreSpaceTotals;
+        issues: SpaceIssue[];
+        error?: string;
+    };
+    summary: {
+        envErrors: number;
+        envWarnings: number;
+        integrityIssues: number;
+        reclaimableSize: number;
+        spaceIssues: number;
+    };
+}
 export declare function createCheckCommand(): Command;
 /**
  * 验证完整性（兼容旧 verify 命令）
  */
 export declare function verifyIntegrity(): Promise<void>;
+export declare function collectCheckResultForTest(options?: {
+    integrity?: boolean;
+}): Promise<CheckResult>;
 /**
  * 修复问题（兼容旧 repair 命令）
  */

package/dist/commands/check.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmCpC,UAAU,cAAc;IACtB,eAAe,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAClD,aAAa,EAAE;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,GAAG,EAAE;YAAE,OAAO,EAAE,MAAM,CAAC;YAAC,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;KAC1C,EAAE,CAAC;IACJ,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,gBAAgB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzE,eAAe,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAChF,eAAe,EAAE;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,oBAAoB,GAAG,0BAA0B,CAAC;QACzD,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,QAAQ,EAAE;YAAE,SAAS,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACtE,MAAM,EAAE;YAAE,SAAS,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACnE,EAAE,CAAC;CACL;AAuBD,wBAAgB,kBAAkB,IAAI,OAAO,CAW5C;AA23BD;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,MAAM,EAAE,OAAO,CAAC;IAChB,KAAK,EAAE,OAAO,CAAC;CAChB,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBhB;AAED;;;;;;GAMG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC,iBAAiB,CAAC,CAAC,CAqEtF;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,cAAc,CAAC,iBAAiB,CAAC,GAC3C,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../../src/commands/check.ts"],"names":[],"mappings":"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"}