@lesliechan721/aw 0.1.0-beta.10

package/dist/src/tui/operation-review-planner.js

@@ -0,0 +1,622 @@
+import { requestedIntentAction } from '../output/command-receipt.js';
+import { catalogSourceAutoCheckOnlyValue } from './catalog-sources/review.js';
+function plannerError(code, message) {
+    return new Error(`${code}: ${message}`);
+}
+function pluginNameFromId(pluginId) {
+    const separator = pluginId.indexOf('/');
+    return separator < 0 ? pluginId : pluginId.slice(separator + 1);
+}
+function operationLabels(intent, evidence) {
+    if (intent.kind === 'catalogSourcesRecovery') {
+        return {
+            title: '恢复 Catalog 来源配置',
+            description: '备份损坏配置，并恢复唯一的主来源 official。',
+            primaryLabel: '备份并恢复官方默认来源',
+            destructive: false,
+        };
+    }
+    if (intent.kind === 'portableInstall') {
+        return {
+            title: '确认安装通用 Skills',
+            description: '只安装已选择的 Skills；不会修改原生插件安装。',
+            primaryLabel: `开始安装 ${intent.selectedSkills.length} 个 Skills`,
+            destructive: false,
+        };
+    }
+    if (intent.kind === 'pluginWrite' && intent.dependencyPlacementAdjustment) {
+        return {
+            title: '调整依赖位置',
+            description: '按最终依赖位置更新 desired intent，并应用非破坏性变更。',
+            primaryLabel: '应用依赖位置',
+            destructive: false,
+        };
+    }
+    if (intent.kind === 'pluginWrite') {
+        if (intent.originIssue) {
+            if (intent.action === 'cleanup') {
+                return {
+                    title: '清理已安装内容',
+                    description: '只清理可证明属于 AW 的现场内容；保留插件设置。',
+                    primaryLabel: '开始清理',
+                    destructive: true,
+                };
+            }
+            return {
+                title: '处理问题',
+                description: '只执行所选问题处理动作；插件设置保持不变。',
+                primaryLabel: '开始处理',
+                destructive: intent.action !== 'reinstall',
+            };
+        }
+        if (intent.action === 'cleanup' && intent.force === true) {
+            return {
+                title: '强制清理插件',
+                description: '跳过依赖保护并清理可证明属于 AW 的现场内容。依赖者会变为不完整。配置保持不变。',
+                primaryLabel: '确认强制清理',
+                destructive: true,
+            };
+        }
+        const labels = {
+            install: ['添加插件', '添加所选平台和使用位置。', false],
+            refreshAndSync: ['刷新并同步', '刷新相关来源后，使用新的 Active 内容同步所选安装。', false],
+            reinstall: ['重新安装插件', '清理 AW 管理的内容后完整重建。', true],
+            uninstall: ['移除插件', '移除 AW 管理的安装内容。配置保持不变。', true],
+            cleanup: ['清理插件', '只移除可证明属于 AW 的现场内容。配置保持不变。', true],
+            sync: ['同步插件', '按已保存的 desired intent 修复当前现场。', false],
+        };
+        const [title, description, destructive] = labels[intent.action];
+        return { title, description, primaryLabel: title, destructive };
+    }
+    if (intent.kind === 'configSave') {
+        if (intent.retryApply) {
+            return {
+                title: '重试应用插件设置',
+                description: '重新读取当前设置和安装证据；不会恢复或重写历史值。',
+                primaryLabel: '重试应用',
+                destructive: false,
+            };
+        }
+        return {
+            title: intent.apply ? '保存并应用插件设置' : '保存插件设置',
+            description: intent.apply
+                ? '保存所选设置层，并重新应用可见安装。'
+                : '只保存所选设置层；当前安装保持不变。',
+            primaryLabel: intent.apply ? '保存并应用' : '保存',
+            destructive: false,
+        };
+    }
+    if (intent.kind === 'configReset') {
+        return {
+            title: '重置插件设置',
+            description: '删除所选设置层的值，恢复继承。',
+            primaryLabel: '重置设置',
+            destructive: true,
+        };
+    }
+    if (intent.kind === 'sourceMutation') {
+        const autoCheck = intent.action === 'update'
+            ? catalogSourceAutoCheckOnlyValue(intent.update) : undefined;
+        if (autoCheck !== undefined) {
+            return {
+                title: '保存自动检查设置',
+                description: '只保存自动检查设置；Active Catalog 和 Catalog store 保持不变。',
+                primaryLabel: '保存设置',
+                destructive: false,
+            };
+        }
+        const labels = {
+            add: ['添加来源', '只保存来源配置。保存后请在终端运行 source sync。', '保存来源', false],
+            update: ['修改来源', '只保存来源配置。保存后请在终端运行 source sync。', '保存来源', false],
+            setPrimary: ['设为主来源', '只改变默认 marketplace，不迁移安装。', '设为主来源', false],
+            remove: ['移除来源', '移除来源配置；不会删除其它来源。', '移除来源', true],
+        };
+        const [title, description, primaryLabel, destructive] = labels[intent.action];
+        return { title, description, primaryLabel, destructive };
+    }
+    if (intent.kind === 'catalogGeneration') {
+        if (intent.action === 'update' && evidence?.catalogGeneration?.exactRepair) {
+            return {
+                title: '验证并精确修复 Catalog',
+                description: '候选与当前 Active store key 相同。精确替换损坏条目，并保留 Active 身份。',
+                primaryLabel: '验证并精确修复',
+                destructive: false,
+            };
+        }
+        const labels = {
+            activate: ['获取并启用 Catalog', '验证候选后启用。不会升级已安装 Plugin，也不会修改其他来源。', '获取并启用'],
+            update: ['验证并切换 Catalog', '验证候选后切换 Active。失败时保留旧 Active。', '验证并切换'],
+            repair: ['重新下载并修复 Catalog', '只修复这个来源的 Active 条目，不删除其他 digest。', '重新下载并修复'],
+            replaceDamaged: ['替换损坏的 Active Catalog', '使用当前候选替换无法精确修复的 Active。失败时保留旧 Active。', '确认并替换'],
+            recoverState: ['恢复 Catalog 状态并启用', '重建无效 generation state，并只激活已确认的目标来源。来源配置和 Catalog store 保持不变。', '恢复状态并启用'],
+        };
+        const [title, description, primaryLabel] = labels[intent.action];
+        return { title, description, primaryLabel, destructive: false };
+    }
+    throw plannerError('operationNotImplemented', '问题修复操作尚未接入。');
+}
+function dependencyRelation(plan, pluginId) {
+    if (plan.requestedPluginIds.includes(pluginId))
+        return 'requested';
+    return plan.dependencyEdges.some((edge) => plan.requestedPluginIds.includes(edge.from) && edge.to === pluginId)
+        ? 'direct'
+        : 'transitive';
+}
+function reviewChanges(intent, evidence, dependencyOverview) {
+    if (intent.kind === 'catalogSourcesRecovery') {
+        return [
+            { kind: 'add', title: '备份损坏的 catalog-sources.json' },
+            { kind: 'change', title: '恢复唯一的主来源 official' },
+            { kind: 'keep', title: '保留 catalog-state.json 和 catalog-store' },
+            {
+                kind: 'warning',
+                title: '自定义来源需要之后重新添加',
+                description: '无法从损坏配置中安全恢复自定义来源。',
+            },
+        ];
+    }
+    if (intent.kind === 'portableInstall') {
+        const review = evidence?.portable;
+        if (!review)
+            throw plannerError('portablePrepareFailed', '缺少通用 Skills Review 证据。');
+        return [
+            ...review.selected.map((skill) => ({
+                kind: 'add',
+                group: skill.relation === 'requested' ? 'requested' : 'dependencies',
+                pluginId: skill.providerPluginId,
+                relation: skill.relation,
+                title: skill.name,
+                description: `${skill.description} · ${skill.providerDisplayName}${skill.dynamic ? ' · 按设置生成' : ''}`,
+            })),
+            { kind: 'change', group: 'portableTarget', title: 'Agent', description: review.agentMode === 'automatic'
+                    ? '自动选择检测到的 Agent；未检测到时可能选择全部 Agent'
+                    : review.requestedAgents.join('、') },
+            { kind: 'change', group: 'portableTarget', title: '范围', description: review.scope === 'project' ? '当前项目' : '所有项目' },
+            { kind: review.dependencies.length > 0 ? 'keep' : 'change', group: 'portableInputs', title: '插件依赖', description: review.dependencies.length > 0
+                    ? `${review.dependencies.length} 个依赖用于生成，不能取消` : '无需插件依赖' },
+            ...(review.collisions.length > 0 ? [{ kind: 'warning', group: 'portableWarnings', title: '同名覆盖',
+                    description: review.collisions.map((collision) => collision.name).join('、') }] : []),
+        ];
+    }
+    if (intent.kind === 'pluginWrite') {
+        const desiredIntentKind = requestedIntentAction(intent.action === 'refreshAndSync' ? 'sync' : intent.action);
+        const runtimeChanges = evidence?.codexManager
+            ? [{
+                    kind: evidence.codexManager.state === 'requires-install' ? 'add' : 'keep',
+                    group: 'runtime',
+                    title: evidence.codexManager.state === 'requires-install'
+                        ? '获取 Codex runtime'
+                        : 'Codex runtime',
+                    description: evidence.codexManager.state === 'requires-install'
+                        ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · AW-managed 缓存`
+                        : evidence.codexManager.state === 'cached'
+                            ? `${evidence.codexManager.packageName}@${evidence.codexManager.version} · 复用 AW-managed 缓存`
+                            : `使用兼容的 system Codex ${evidence.codexManager.version}`,
+                }]
+            : [];
+        const codexChanges = (evidence?.codexReconcilePlans ?? []).flatMap((codexPlan) => [
+            ...codexPlan.sharedNativeActions.map((action) => ({
+                kind: action.action === 'reuse' || action.action === 'none' ? 'keep'
+                    : action.action === 'install' ? 'add' : 'change',
+                group: 'sharedCodexNative',
+                pluginId: action.pluginId,
+                title: action.codexPluginId,
+                description: action.action === 'reuse'
+                    ? '复用已存在的精确 shared native；不建立 ownership ledger'
+                    : `${action.action} · shared${action.affectsOtherScopes ? ' · 可能影响其他项目' : ''}`,
+            })),
+            ...codexPlan.activationActions.user.map((action) => ({
+                kind: action.action === 'none' ? 'keep' : action.desired ? 'change' : 'remove',
+                group: 'userActivation',
+                pluginId: action.pluginId,
+                title: action.codexPluginId,
+                description: `desired=${String(action.desired)} · ${action.action}`,
+            })),
+            ...codexPlan.activationActions.project.map((action) => ({
+                kind: action.action === 'none' ? 'keep' : action.desired ? 'change' : 'remove',
+                group: 'projectActivation',
+                pluginId: action.pluginId,
+                title: action.codexPluginId,
+                description: `desired=${String(action.desired)} · ${action.action}`,
+            })),
+            ...[...codexPlan.extensionWrites, ...codexPlan.extensionRemovals]
+                .map((action) => ({
+                kind: action.action === 'write' ? 'change' : 'remove',
+                group: 'awExtensions',
+                pluginId: action.pluginId,
+                title: action.componentKey,
+                description: `${action.scope} · ${action.action}`,
+            })),
+        ]);
+        const plan = evidence?.dependencyPlan;
+        if (plan && (intent.action === 'install' || intent.action === 'refreshAndSync'
+            || intent.action === 'reinstall' || intent.action === 'sync')) {
+            const changes = plan.targets.map((target) => {
+                const relation = dependencyRelation(plan, target.pluginId);
+                return {
+                    kind: desiredIntentKind,
+                    group: relation === 'requested' ? 'requested' : 'dependencies',
+                    pluginId: target.pluginId,
+                    relation,
+                    title: pluginNameFromId(target.pluginId),
+                    description: `${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.resolvedScope === 'user' ? '所有项目' : '当前项目'}${target.action === 'keep' ? ' · 已可用' : ''}${target.assignmentSource === 'existingWiderTarget' ? ' · 复用健康的所有项目安装' : target.assignmentSource === 'consumerPromotion' ? ' · 随上游依赖一并调整' : ''}`,
+                };
+            });
+            changes.push({
+                kind: 'keep',
+                group: 'preserved',
+                title: intent.dependencyPlacementAdjustment
+                    ? '根插件和插件设置保持不变'
+                    : '插件设置和已有依赖保持不变',
+                description: intent.dependencyPlacementAdjustment
+                    ? '这里只调整所列 dependency placement。'
+                    : '移除根插件时不会自动清理依赖。',
+            });
+            return [...changes, ...codexChanges, ...runtimeChanges];
+        }
+        const platforms = intent.platform === 'both'
+            ? ['codex', 'claude']
+            : [intent.platform];
+        const changes = platforms.map((platform) => ({
+            kind: intent.action === 'uninstall' || intent.action === 'cleanup' ? 'remove' : intent.action === 'install' ? 'add' : 'change',
+            group: 'requested',
+            pluginId: intent.pluginId,
+            relation: 'requested',
+            title: `${platform === 'codex' ? 'Codex' : 'Claude Code'} · ${intent.scope === 'user' ? '所有项目' : '当前项目'}`,
+            description: intent.action === 'uninstall' || intent.action === 'cleanup'
+                ? '插件设置不会删除。'
+                : '执行前会再次检查当前安装状态。',
+        }));
+        if (intent.action === 'cleanup' && evidence?.offlineCleanup) {
+            const actionLabels = {
+                removeOwnedOutput: '移除 AW-owned 输出',
+                removeNativeRegistration: '移除原生插件注册',
+            };
+            changes.push(...evidence.offlineCleanup.plan.actions.map((action) => ({
+                kind: 'remove',
+                group: 'requested',
+                pluginId: evidence.offlineCleanup.pluginId,
+                relation: 'requested',
+                title: actionLabels[action.action],
+                description: action.target,
+            })));
+        }
+        if (intent.action === 'uninstall' || intent.action === 'cleanup') {
+            changes.push(...(dependencyOverview?.dependencies ?? []).map((dependency) => ({
+                kind: 'keep',
+                group: 'preserved',
+                pluginId: dependency.pluginId,
+                relation: dependency.relation === 'direct' ? 'direct' : 'transitive',
+                title: dependency.displayName,
+                description: '依赖保持安装。',
+            })));
+        }
+        if (intent.action === 'cleanup' && intent.force === true) {
+            changes.push({
+                kind: 'warning',
+                title: '跳过依赖保护',
+                description: '依赖此插件的插件会变为不完整，需重新安装后恢复。',
+            });
+        }
+        if (intent.originIssue) {
+            changes.push({ kind: 'keep', title: '插件设置保持不变' }, { kind: 'warning', title: '执行前重新检查完整目标和来源证据' });
+        }
+        if (intent.recoveryDescription) {
+            changes.push({
+                kind: 'warning',
+                group: 'preserved',
+                title: `后续：${intent.scope === 'user' ? '当前项目' : '所有项目'} sync`,
+                description: intent.recoveryDescription,
+            });
+        }
+        return [...changes, ...codexChanges, ...runtimeChanges];
+    }
+    if (intent.kind === 'configReset') {
+        const layerLabel = intent.scope === 'user'
+            ? '个人默认'
+            : '当前项目';
+        return [
+            ...(intent.changes?.map((change) => ({
+                kind: 'remove', group: 'configChanges', title: `${layerLabel} · ${change.title}`,
+                description: change.children && change.children.length > 0
+                    ? `${change.before} → ${change.after}；${change.children.length} 个子项变化；${change.children.map((child) => `${child.property}: ${child.private ? '已设置 → 将更新' : `${child.before} → ${child.after}`}`).join('；')}`
+                    : `${change.before} → ${change.after}`,
+            })) ?? [{ kind: 'remove', group: 'configChanges', title: `删除${layerLabel}中的已存值`, description: '删除整个设置层且不创建备份；有效值将恢复为继承值或默认值。' }]),
+            { kind: 'keep', group: 'configImpact', title: '只保存设置；当前安装保持不变' },
+            { kind: 'keep', group: 'preserved', title: intent.scope === 'user' ? '当前项目设置保持不变' : '个人默认保持不变' },
+        ];
+    }
+    if (intent.kind === 'sourceMutation') {
+        const changes = (intent.changes ?? []).map((change) => ({
+            kind: intent.action === 'remove' ? 'remove' : intent.action === 'add' ? 'add' : 'change',
+            title: change.title,
+            ...(change.private
+                ? { description: change.before ? '已设置 → 将更新' : '已选择' }
+                : change.before || change.after
+                    ? { description: `${change.before ?? '未设置'} → ${change.after ?? '未设置'}` }
+                    : {}),
+        }));
+        if (intent.action === 'add')
+            changes.push({ kind: 'keep', title: '保留现有主来源' });
+        if (intent.action === 'setPrimary')
+            changes.push({ kind: 'keep', title: '同名插件选择保持不变' }, { kind: 'keep', title: '现有安装和设置不会迁移' });
+        if (intent.action === 'remove')
+            changes.push({ kind: 'keep', title: '保留其他来源' });
+        const impact = evidence?.sourceWrite?.impact;
+        if (impact) {
+            for (const category of ['installation', 'config', 'lifecycle', 'marketplace']) {
+                const count = impact.affectedReferences.filter((reference) => reference.category === category).length;
+                if (count > 0)
+                    changes.push({
+                        kind: 'warning',
+                        title: `${category === 'installation' ? '安装' : category === 'config' ? '设置' : category === 'lifecycle' ? '生命周期意图' : 'Marketplace'}引用受影响`,
+                        description: `${count} 项`,
+                    });
+            }
+            if (!impact.inventoryComplete)
+                changes.push({
+                    kind: 'warning',
+                    title: '来源影响未知',
+                    description: '部分状态无法读取；不能把影响视为零。',
+                });
+        }
+        return changes;
+    }
+    if (intent.kind === 'catalogGeneration') {
+        const generation = evidence?.catalogGeneration;
+        if (!generation) {
+            throw plannerError('catalogGenerationUnavailable', '缺少 Catalog 候选证据。');
+        }
+        return [
+            ...(generation.previousActive ? [{
+                    kind: 'keep',
+                    title: generation.previousActiveVersion
+                        ? `当前 Active Catalog ${generation.previousActiveVersion}` : '当前 Active',
+                    description: `${generation.previousActive.resolvedCommit.slice(0, 8)} · ${generation.previousActive.snapshotDigest.slice(0, 15)}`,
+                }] : []),
+            {
+                kind: intent.action === 'activate' ? 'add' : 'change',
+                title: generation.exactRepair
+                    ? `精确修复候选 Catalog ${generation.candidate.catalogVersion}`
+                    : `候选 Catalog ${generation.candidate.catalogVersion}`,
+                description: `${generation.candidate.resolvedCommit.slice(0, 8)} · ${generation.candidate.snapshotDigest.slice(0, 15)}`,
+            },
+            ...(generation.exactRepair ? [{
+                    kind: 'change',
+                    title: '精确替换损坏的 Active 条目',
+                    description: 'logical identity、snapshot digest、manifest digest 和 commit 保持不变。',
+                }] : []),
+            ...(intent.action === 'replaceDamaged' ? [{
+                    kind: 'warning',
+                    title: '使用当前候选替换损坏的 Active',
+                    description: '旧版本无法安全比较；确认后只切换到本次绑定的当前候选。',
+                }] : []),
+            ...(generation.sourceMutation ? [{
+                    kind: generation.sourceMutation.action === 'add' ? 'add' : 'change',
+                    title: generation.sourceMutation.action === 'add' ? '保存来源配置'
+                        : 'url' in generation.sourceMutation.update ? 'Git URL'
+                            : 'path' in generation.sourceMutation.update ? '本地目录'
+                                : 'refPolicy' in generation.sourceMutation.update
+                                    && generation.sourceMutation.update.refPolicy ? 'Git ref policy'
+                                    : 'subdir' in generation.sourceMutation.update
+                                        && generation.sourceMutation.update.subdir !== undefined ? 'Catalog 子目录'
+                                        : '更新来源配置',
+                    description: `${generation.configDigest.slice(0, 8)} → ${generation.proposedConfigDigest?.slice(0, 8) ?? '未知'}`,
+                }] : []),
+            ...(generation.explicitSourceChange && generation.candidateRelation === 'rollbackDetected' ? [{
+                    kind: 'warning',
+                    title: '显式来源切换将降低 Catalog 版本',
+                    description: `${generation.previousActiveVersion ?? '当前版本'} → ${generation.candidate.catalogVersion}`,
+                }] : generation.explicitSourceChange && generation.candidateRelation === 'versionConflict' ? [{
+                    kind: 'warning',
+                    title: '显式来源切换包含同版本不同内容',
+                    description: `${generation.candidate.catalogVersion} · ${generation.candidate.snapshotDigest.slice(0, 15)}`,
+                }] : generation.explicitSourceChange && generation.candidateRelation === 'incompatible' ? [{
+                    kind: 'warning',
+                    title: '显式来源切换将改变 Catalog logical identity',
+                    description: '确认前请核对新来源身份和候选摘要。',
+                }] : []),
+            ...((generation.impact?.affectedReferences ?? []).length > 0 ? [{
+                    kind: 'warning',
+                    title: '现有引用受候选变化影响',
+                    description: `${generation.impact.affectedReferences.length} 项；已安装插件不会自动修改。`,
+                }] : []),
+            ...(generation.impact && !generation.impact.inventoryComplete ? [{
+                    kind: 'warning',
+                    title: '候选影响未知',
+                    description: '部分状态或旧 Manifest 无法读取；不能把影响视为零。',
+                }] : []),
+            { kind: 'keep', title: '不会升级已安装 Plugin' },
+            { kind: 'keep', title: intent.action === 'recoverState'
+                    ? '不会修改其他来源配置或 store' : '不会修改其他来源' },
+            { kind: 'keep', title: '失败时保留旧 Active' },
+            ...(intent.action === 'recoverState' ? [{
+                    kind: 'warning',
+                    title: '无效 state 中的其他 Active 指针不会被信任或保留',
+                    description: '其他来源配置和 store 内容不会删除；可分别重新启用。',
+                }] : []),
+        ];
+    }
+    if (intent.kind !== 'configSave') {
+        throw plannerError('operationNotImplemented', '这个写操作尚未接入新 Controller。');
+    }
+    const privateKeys = new Set([...(intent.sensitiveKeys ?? []), ...(intent.privateKeys ?? [])]);
+    const removeKeys = new Set(intent.removeKeys ?? []);
+    const layerLabel = intent.scope === 'user' ? '个人默认' : '当前项目';
+    if (intent.retryApply) {
+        return [
+            ...(evidence?.config?.affectedTargets.map((target) => ({
+                kind: 'change',
+                group: 'configImpact',
+                title: `重新应用 ${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.scope === 'user' ? '所有项目' : '当前项目'}`,
+            })) ?? []),
+            { kind: 'keep', group: 'preserved', title: `${layerLabel}中的当前值保持不变` },
+            { kind: 'keep', group: 'preserved', title: '不会恢复历史设置值' },
+        ];
+    }
+    if (intent.changes) {
+        const hasAffectedCodexTarget = evidence?.config?.affectedTargets.some((target) => target.platform === 'codex') ?? false;
+        const sharedNativeTargets = hasAffectedCodexTarget
+            ? evidence?.config?.sharedNativeRenderTargets ?? []
+            : [];
+        const sharedNativeImpact = sharedNativeTargets.length === 0
+            ? []
+            : intent.apply
+                ? [
+                    {
+                        kind: 'change', group: 'configImpact',
+                        title: `重新生成 ${sharedNativeTargets.map((target) => target.skillKey).join('、')} 动态 Skill`,
+                        description: '配置来源为个人默认；更新共享 Codex native 插件会影响所有启用项目。',
+                    },
+                    { kind: 'keep', group: 'preserved', title: '保留当前 user/project activation' },
+                    { kind: 'keep', group: 'preserved', title: 'project Agent role 继续按当前项目配置' },
+                ]
+                : [
+                    {
+                        kind: 'warning', group: 'configImpact',
+                        title: '共享 Codex native render 待同步',
+                        description: '个人默认已保存；动态 Skill 尚未重新生成。',
+                    },
+                    { kind: 'keep', group: 'preserved', title: '当前 native 插件和 activation 保持不变' },
+                    { kind: 'keep', group: 'preserved', title: 'project Agent role 继续按当前项目配置' },
+                ];
+        return [
+            ...intent.changes.map((change) => ({
+                kind: removeKeys.has(change.key) ? 'remove' : 'change',
+                group: 'configChanges',
+                title: removeKeys.has(change.key)
+                    ? `${layerLabel} · 删除 ${change.title} 中的值`
+                    : `${layerLabel} · ${change.title}`,
+                description: change.children && change.children.length > 0
+                    ? `${change.before} → ${change.after}；${change.children.length} 个子项变化；${change.children.map((child) => `${child.property}: ${child.private ? '已设置 → 将更新' : `${child.before} → ${child.after}`}`).join('；')}`
+                    : removeKeys.has(change.key)
+                        ? privateKeys.has(change.key) ? `已设置 → ${change.after}` : `${change.before} → ${change.after}`
+                        : privateKeys.has(change.key) ? '已设置 → 将更新'
+                            : `${change.before} → ${change.after}`,
+            })),
+            ...sharedNativeImpact,
+            ...(sharedNativeTargets.length > 0
+                ? []
+                : intent.apply && (evidence?.config?.affectedTargets.length ?? 0) > 0
+                    ? evidence.config.affectedTargets.map((target) => ({
+                        kind: 'change', group: 'configImpact', title: `重新应用 ${target.platform === 'codex' ? 'Codex' : 'Claude Code'} · ${target.scope === 'user' ? '所有项目' : '当前项目'}`,
+                    }))
+                    : [{ kind: 'keep', group: 'configImpact', title: '当前没有可见安装；只保存设置' }]),
+            { kind: 'keep', group: 'preserved', title: '其他项目不会被自动扫描' },
+        ];
+    }
+    const updateKeys = Object.keys(intent.updates ?? {});
+    return [
+        ...updateKeys.map((key) => ({
+            kind: 'change',
+            title: key,
+            description: privateKeys.has(key) ? '已设置 → 将更新' : '将更新',
+        })),
+        ...(intent.removeKeys ?? []).map((key) => ({
+            kind: 'remove',
+            title: key,
+            description: privateKeys.has(key) ? '已设置 → 未设置' : '恢复继承',
+        })),
+    ];
+}
+function technicalDetails(evidence) {
+    const short = (value) => {
+        const normalized = value.startsWith('sha256:') ? value.slice(7) : value;
+        return normalized.slice(0, 8);
+    };
+    const details = [
+        `Catalog 配置：${short(evidence.catalog.configDigest)}`,
+        `Catalog 组合：${short(evidence.catalog.compositeDigest)}`,
+    ];
+    if (evidence.catalog.generationSetDigest) {
+        details.push(`Catalog generation：${short(evidence.catalog.generationSetDigest)}`);
+    }
+    if (evidence.source) {
+        details.push(`来源：${evidence.source.sourceId}`);
+        if (evidence.source.sourceIdentity)
+            details.push(`来源身份：${short(evidence.source.sourceIdentity)}`);
+        if (evidence.source.resolvedCommit)
+            details.push(`Snapshot commit：${short(evidence.source.resolvedCommit)}`);
+        if (evidence.source.snapshotDigest)
+            details.push(`Snapshot digest：${short(evidence.source.snapshotDigest)}`);
+        if (evidence.source.contentDigest)
+            details.push(`Content digest：${short(evidence.source.contentDigest)}`);
+    }
+    if (evidence.targetFingerprint)
+        details.push(`目标状态：${short(evidence.targetFingerprint)}`);
+    details.push(...(evidence.preparationWarnings ?? []).map((warning) => `刷新警告：${warning}`));
+    if (evidence.offlineCleanup) {
+        details.push(`离线清理原因：${evidence.offlineCleanup.reason}`);
+        details.push(`离线清理目标：${short(evidence.offlineCleanup.targetFingerprint)}`);
+        details.push(`离线清理计划：${evidence.offlineCleanup.plan.actions.length} 个动作 · ${short(evidence.offlineCleanup.planDigest)}`);
+        for (const action of evidence.offlineCleanup.plan.actions) {
+            details.push(`离线清理动作：${action.action} · ${action.target}`);
+        }
+    }
+    if (evidence.dependencyPlan)
+        details.push(`安装计划：${evidence.dependencyPlan.resolvedPluginIds.length} 个插件`);
+    if (evidence.config)
+        details.push(`设置层：${evidence.config.scope} · ${short(evidence.config.storeDigest)}`);
+    if (evidence.sourceWrite) {
+        details.push(`新配置：${short(evidence.sourceWrite.proposedConfigDigest)}`);
+        details.push(`引用清单：${short(evidence.sourceWrite.inventoryDigest)} · ${evidence.sourceWrite.referenceCount} 项`);
+    }
+    if (evidence.catalogGeneration) {
+        const generation = evidence.catalogGeneration;
+        details.push(`候选版本：${generation.candidate.catalogVersion}`);
+        details.push(`候选 commit：${short(generation.candidate.resolvedCommit)}`);
+        details.push(`候选 digest：${short(generation.candidate.snapshotDigest)}`);
+    }
+    if (evidence.portable) {
+        details.push(`Portable 候选：${evidence.portable.selected.length} 个`);
+        details.push(`Materialization：${short(evidence.portable.materializationDigest)}`);
+        details.push(`Skills CLI：${evidence.portable.skillsCliVersion}`);
+    }
+    return details;
+}
+export function buildOperationReviewProjection(options) {
+    const { intent, evidence } = options;
+    const labels = operationLabels(intent, evidence);
+    const requiresConfirmation = (evidence.codexReconcilePlans ?? []).some((plan) => plan.review.requiresConfirmation)
+        || Boolean(evidence.sourceWrite
+            && (!evidence.sourceWrite.inventoryComplete || evidence.sourceWrite.referenceCount > 0))
+        || Boolean(evidence.catalogGeneration?.impact
+            && (!evidence.catalogGeneration.impact.inventoryComplete
+                || evidence.catalogGeneration.impact.affectedReferences.length > 0));
+    const warning = (evidence.codexReconcilePlans ?? []).find((plan) => plan.review.sharedImpact.warning)?.review.sharedImpact.warning;
+    const preparationWarnings = (evidence.preparationWarnings ?? []).map(() => ({
+        kind: 'warning',
+        group: 'portableWarnings',
+        title: '来源刷新失败；本次使用旧 Active',
+        description: '同步可以继续。再次刷新并同步时会重试来源刷新。',
+    }));
+    return {
+        title: labels.title,
+        description: labels.description,
+        changes: [
+            ...preparationWarnings,
+            ...reviewChanges(intent, evidence, options.dependencyOverview),
+        ],
+        technicalDetails: technicalDetails(evidence),
+        ...(intent.kind === 'pluginWrite'
+            ? { equivalentCommand: `aw ${intent.action === 'refreshAndSync' ? 'sync' : intent.action} ${intent.pluginId} --platform ${intent.platform} --scope ${intent.scope}${intent.action === 'refreshAndSync' ? ' --refresh' : ''}${(intent.dependencyScopeOverrides ?? []).map((override) => ` --dependency-scope ${override.pluginId}#${override.platform}=${override.scope}`).join('')}${intent.action === 'cleanup' && intent.force === true ? ' --force' : ''}${evidence.codexManager?.state === 'requires-install' ? ' --allow-managed-codex-install' : ''}${requiresConfirmation ? ' --yes' : ''}` }
+            : {}),
+        primaryLabel: intent.kind === 'pluginWrite' && evidence.dependencyPlan
+            ? `${labels.primaryLabel} ${evidence.dependencyPlan.resolvedPluginIds.length} 个插件`
+            : labels.primaryLabel,
+        ...(labels.destructive ? { destructive: true } : {}),
+        requiresConfirmation,
+        sharedImpact: {
+            pluginIds: [...new Set([
+                    ...(evidence.codexReconcilePlans ?? []).flatMap((plan) => plan.review.sharedImpact.pluginIds),
+                    ...(evidence.sourceWrite?.impact?.affectedReferences ?? []).flatMap((reference) => reference.pluginId ? [reference.pluginId] : []),
+                    ...(evidence.catalogGeneration?.impact?.affectedReferences ?? []).flatMap((reference) => reference.pluginId ? [reference.pluginId] : []),
+                ])],
+            ...(warning ? { warning }
+                : requiresConfirmation && (evidence.sourceWrite || evidence.catalogGeneration?.impact)
+                    ? { warning: '确认来源影响后才会继续。未知影响不会按零处理。' }
+                    : {}),
+        },
+    };
+}
+//# sourceMappingURL=operation-review-planner.js.map