@lesliechan721/aw 0.1.0-beta.7 → 0.1.0-beta.9

package/dist/src/tui/controller-runtime.js

@@ -1,5 +1,6 @@
 import crypto from 'node:crypto';
-import { statusCommandV4, } from '../commands/status-v4.js';
+import path from 'node:path';
+import { statusCommandV6, } from '../commands/status-v6.js';
 import { addCatalogSourceCommand, listCatalogSources, preflightCatalogSourceMutation, removeCatalogSourceCommand, setPrimaryCatalogSourceCommand, updateCatalogSourceCommand, } from '../commands/catalog-source.js';
 import { cleanupWriteCommand, installWriteCommand, reinstallWriteCommand, uninstallWriteCommand, upgradeWriteCommand, } from '../commands/write-commands.js';
 import { readCliPackageInfo } from '../utils/local-marketplace.js';
@@ -7,28 +8,42 @@ import { readCatalogSourcesConfigSnapshot, } from '../utils/catalog-sources.js';
 import { withResolvedCatalogPlugin, withResolvedMultiSourceCatalog, formatPluginId, parsePluginId, } from '../utils/multi-source-catalog.js';
 import { coercePluginConfigUpdates, readNamespacedPluginConfigStoreIdentity, readPluginConfigStore, resolveConfigRead, } from '../utils/plugin-config.js';
 import { applyPluginConfigWrite, resetPluginConfigWithHelper, } from '../utils/plugin-config-write.js';
+import { offlineCleanupEvidenceFromInventory, } from '../commands/offline-cleanup-evidence.js';
+import { inventoryCatalogSourceReferences } from '../utils/catalog-source-references.js';
 import { operationEvidenceFingerprint, TuiController, TuiOperationBlockedError, } from './controller.js';
-import { buildConfigGroups, buildConfigPage, projectPlatformPlacement, } from './model.js';
+import { buildConfigGroups, buildConfigPage, isPureNativeCodexTarget, projectPlatformPlacement, } from './model.js';
 import { projectCatalogSourceLocation } from '../utils/catalog-source-presentation.js';
-import { targetCanBeUninstalled } from '../utils/target-eligibility.js';
+import { targetCanBeUninstalled, targetHasArtifactCollision, } from '../utils/target-eligibility.js';
 import { calculateCatalogSourceIdentity } from '../utils/catalog-source-identity.js';
-import { resolvePluginsFromCatalog } from '../utils/manifest.js';
+import { checkAwCapabilitySupport, readPluginManifest } from '../utils/manifest.js';
 import { withAwHomeMutationLock } from '../utils/aw-home-mutation-lock.js';
+import { IMPLEMENTED_AW_CAPABILITIES } from '../commands/aw-capabilities.js';
+import { resolveCatalogOperationContext, resolvePartialCatalogOperationContext, selectCatalogOperationContext, } from '../utils/catalog-operation-context.js';
+import { loadCatalogGenerationViewModels } from './catalog-generation.js';
 import { installPortableSkills, preparePortableInstall, PortableCommandError, } from '../portable/commands.js';
+import { MANAGED_CODEX_PACKAGE_NAME, MANAGED_CODEX_VERSION, } from '../utils/codex-manager.js';
+import { calculatePluginIntentDigest, canonicalizePluginIntentState, readPluginIntentState, writePluginIntentState, } from '../utils/plugin-intent-state.js';
 async function loadPortablePluginIds(options) {
     return withResolvedMultiSourceCatalog({
         cliVersion: options.cliVersion,
-        freshnessPolicy: 'cacheFirst',
         env: options.context.env,
         signal: options.signal,
+        ...(options.catalogOperationContext
+            ? { operationContext: options.catalogOperationContext }
+            : {}),
         consume: async (catalog) => (await Promise.all(catalog.sources.flatMap((item) => item.resolution
-            ? [resolvePluginsFromCatalog(item.resolution.rootDir, undefined).then((plugins) => plugins
-                    .filter((plugin) => plugin.manifest.distributions?.agentSkills)
-                    .map((plugin) => formatPluginId({
-                    sourceId: item.resolution.sourceId,
-                    pluginName: plugin.manifest.name,
-                })))]
-            : []))).flat(),
+            ? item.resolution.manifest.entries.flatMap((entry) => {
+                const support = checkAwCapabilitySupport(entry.requires.aw.capabilities ?? [], IMPLEMENTED_AW_CAPABILITIES);
+                return support.supported
+                    ? [readPluginManifest(path.join(item.resolution.rootDir, 'plugins', entry.name), { mode: 'bundle' }).then((plugin) => plugin.manifest.distributions?.agentSkills
+                            ? formatPluginId({
+                                sourceId: item.resolution.sourceId,
+                                pluginName: entry.name,
+                            })
+                            : null)]
+                    : [];
+            })
+            : []))).filter((pluginId) => pluginId !== null),
     });
 }
 let tuiControllerRuntimeTestHooks;
@@ -60,6 +75,13 @@ export function statusTargetFingerprint(targets, revisions = []) {
             .localeCompare([right.pluginId, right.platform, right.scope].join('\0'), 'en')),
     });
 }
+export function configAffectedStatusTargets(targets, pluginId, configScope) {
+    return targets.filter((target) => target.pluginId === pluginId
+        && (configScope === 'user' || target.scope === 'project')
+        && (target.state === 'present' || target.state === 'partial'))
+        .sort((left, right) => `${left.platform}\0${left.scope}`
+        .localeCompare(`${right.platform}\0${right.scope}`, 'en'));
+}
 function operationReviewStale(message) {
     return new TuiOperationBlockedError('operationReviewStale', `operationReviewStale: ${message}`);
 }
@@ -73,6 +95,8 @@ function sourceEvidenceForPlugin(source, pluginName) {
         manifestDigest: source.manifestDigest,
         snapshotDigest: source.snapshotDigest,
         contentDigest: entry.contentDigest,
+        catalogVersion: source.manifest.catalogVersion,
+        channel: source.manifest.channel,
     };
 }
 function assertSourceEvidenceMatches(expected, actual) {
@@ -92,8 +116,6 @@ function throwIfWriteReviewStale(result) {
     }
 }
 const SOURCE_PROGRESS_PHASES = {
-    refreshingCatalog: '刷新 Catalog 缓存',
-    catalogReady: 'Catalog 已读取，索引已刷新',
     savingConfig: '保存来源配置',
 };
 function pluginIntent(intent) {
@@ -104,20 +126,48 @@ function assertIntentIsLegal(intent, targets, revisions = []) {
         ? ['codex', 'claude']
         : [intent.platform];
     for (const platform of platforms) {
-        const selected = targets.find((target) => target.pluginId === intent.pluginId
-            && target.platform === platform && target.scope === intent.scope);
+        const platformTargets = targets.filter((target) => target.pluginId === intent.pluginId
+            && target.platform === platform);
+        const selected = platformTargets.find((target) => target.scope === intent.scope)
+            ?? (platform === 'codex' ? platformTargets[0] : undefined);
         if (!selected || selected.errors.some((error) => error.code === 'unsupportedTarget')) {
             throw new TuiOperationBlockedError('unsupportedTarget', '所选插件不支持这个平台和使用位置。');
         }
-        const otherScopeInstalled = targets.some((target) => target.platform === platform
-            && target.scope !== intent.scope
-            && (target.state === 'present' || target.state === 'partial'));
-        if (intent.action === 'install' && otherScopeInstalled) {
+        if (intent.action === 'sync' && platform !== 'codex') {
+            throw new TuiOperationBlockedError('syncPlatformUnsupported', 'sync 只支持 Codex。');
+        }
+        if (intent.dependencyPlacementOnly === 'desired')
+            continue;
+        const otherScope = intent.scope === 'user' ? 'project' : 'user';
+        const otherScopeInstalled = platform === 'codex'
+            ? platformTargets.some((target) => target.desired.scopes.includes(otherScope)
+                || target.activation?.[otherScope] === true)
+            : targets.some((target) => target.platform === platform
+                && target.scope !== intent.scope
+                && (target.state === 'present' || target.state === 'partial'));
+        const pureNativeCodex = isPureNativeCodexTarget(selected);
+        if (intent.action === 'install' && otherScopeInstalled && !pureNativeCodex
+            && !intent.dependencyPlacementAdjustment) {
             throw new TuiOperationBlockedError('scopeConflict', '这个平台已安装在另一个使用位置。请先移除原位置。');
         }
-        if (intent.action === 'install' && selected.state !== 'absent') {
+        if ((intent.action === 'install' || intent.action === 'upgrade' || intent.action === 'reinstall')
+            && targetHasArtifactCollision(selected)) {
+            throw new TuiOperationBlockedError('artifactCollision', '所选位置存在输出冲突。请先移除或迁移冲突内容。');
+        }
+        const selectedScopeInstalled = platform === 'codex'
+            ? selected.desired.scopes.includes(intent.scope)
+                || selected.activation?.[intent.scope] === true
+            : selected.state !== 'absent';
+        if (intent.action === 'install' && selectedScopeInstalled
+            && !intent.dependencyPlacementAdjustment) {
             throw new TuiOperationBlockedError('targetAlreadyInstalled', '所选位置已经安装。');
         }
+        if (intent.action === 'sync'
+            && selected.actual.state !== 'needsSync'
+            && selected.actual.state !== 'drifted'
+            && selected.actual.state !== 'conflict') {
+            throw new TuiOperationBlockedError('targetStateChanged', '当前安装状态不需要同步。');
+        }
         const revision = revisions.find((entry) => entry.pluginId === intent.pluginId
             && entry.platform === platform && entry.scope === intent.scope)?.revision;
         if (intent.action === 'upgrade'
@@ -140,7 +190,9 @@ async function assertTypedIssueOrigin(intent, targets) {
     };
     const selected = targets.find((target) => target.pluginId === intent.pluginId
         && target.platform === intent.platform
-        && target.scope === intent.scope);
+        && target.scope === intent.scope)
+        ?? targets.find((target) => target.pluginId === intent.pluginId
+            && target.platform === 'codex');
     if (intent.originIssue.category === 'dependencyMissing') {
         if (intent.originIssue.actionId !== 'installDependency'
             || intent.action !== 'install' || !selected || selected.state !== 'absent') {
@@ -169,10 +221,25 @@ async function assertTypedIssueOrigin(intent, targets) {
         }
         return;
     }
+    else if (intent.originIssue.category === 'sourceMissing') {
+        if (intent.originIssue.actionId !== 'cleanup' || intent.action !== 'cleanup'
+            || !selected || !selected.errors.some((error) => error.code === 'sourceMissing')) {
+            stale('原来源缺失问题已变化。');
+        }
+        return;
+    }
     else if (intent.originIssue.category === 'scopeConflict') {
-        const installedScopes = new Set(targets.filter((target) => target.pluginId === intent.pluginId
-            && target.platform === intent.platform
-            && (target.state === 'present' || target.state === 'partial')).map((target) => target.scope));
+        const installedScopes = new Set();
+        for (const target of targets.filter((candidate) => candidate.pluginId === intent.pluginId && candidate.platform === intent.platform)) {
+            if (target.state === 'present' || target.state === 'partial')
+                installedScopes.add(target.scope);
+            for (const scope of target.desired.scopes)
+                installedScopes.add(scope);
+            if (target.activation?.user === true)
+                installedScopes.add('user');
+            if (target.activation?.project === true)
+                installedScopes.add('project');
+        }
         const correctBranch = intent.action === 'uninstall'
             && ((intent.originIssue.actionId === 'keepUserScope' && intent.scope === 'project')
                 || (intent.originIssue.actionId === 'keepProjectScope' && intent.scope === 'user'));
@@ -202,25 +269,29 @@ async function assertTypedIssueOrigin(intent, targets) {
 async function loadDependencyOverviews(options) {
     const graph = await withResolvedMultiSourceCatalog({
         cliVersion: options.cliVersion,
-        freshnessPolicy: 'cacheFirst',
         env: options.context.env,
         signal: options.signal,
+        ...(options.catalogOperationContext
+            ? { operationContext: options.catalogOperationContext }
+            : {}),
         consume: async (catalog) => ({
-            nodes: (await Promise.all(catalog.sources.flatMap((item) => item.resolution
-                ? [resolvePluginsFromCatalog(item.resolution.rootDir, undefined).then((plugins) => plugins.map((plugin) => ({
-                        pluginId: formatPluginId({
-                            sourceId: item.resolution.sourceId,
-                            pluginName: plugin.manifest.name,
-                        }),
-                        displayName: plugin.manifest.interface?.displayName ?? plugin.manifest.name,
-                        dependencies: (plugin.manifest.dependencies ?? []).map((pluginName) => formatPluginId({ sourceId: item.resolution.sourceId, pluginName })),
-                    })))] : []))).flat(),
+            nodes: catalog.sources.flatMap((item) => item.resolution
+                ? item.resolution.manifest.entries.map((entry) => ({
+                    pluginId: formatPluginId({
+                        sourceId: item.resolution.sourceId,
+                        pluginName: entry.name,
+                    }),
+                    displayName: entry.interface?.displayName ?? entry.name,
+                    dependencies: entry.dependencies.map((pluginName) => formatPluginId({ sourceId: item.resolution.sourceId, pluginName })),
+                }))
+                : []),
             sourceErrors: catalog.sources.flatMap((item) => item.error
                 ? [{ sourceId: item.sourceId, code: 'dependencyGraphInvalid' }]
                 : []),
         }),
     });
     const nodes = new Map(graph.nodes.map((node) => [node.pluginId, node]));
+    const summaryById = new Map(options.status.pluginSummaries.map((summary) => [summary.pluginId, summary]));
     const displayName = (pluginId) => nodes.get(pluginId)?.displayName
         ?? parsePluginId(pluginId).pluginName;
     const reverse = new Map();
@@ -233,6 +304,9 @@ async function loadDependencyOverviews(options) {
     for (const target of options.status.payload.targets) {
         targetsByPlugin.set(target.pluginId, [...(targetsByPlugin.get(target.pluginId) ?? []), target]);
     }
+    const unsupportedPluginIds = new Set(options.status.pluginSummaries
+        .filter((summary) => (summary.missingCapabilities?.length ?? 0) > 0)
+        .map((summary) => summary.pluginId));
     const placementReferences = new Map();
     for (const consumer of options.status.payload.targets.filter((target) => target.state !== 'absent')) {
         const consumerNode = nodes.get(consumer.pluginId);
@@ -279,13 +353,15 @@ async function loadDependencyOverviews(options) {
     };
     const aggregateFor = (pluginId, placements) => {
         const sourceId = parsePluginId(pluginId).sourceId;
-        if (graph.sourceErrors.some((error) => error.sourceId === sourceId))
+        if (graph.sourceErrors.some((error) => error.sourceId === sourceId)
+            || unsupportedPluginIds.has(pluginId))
             return 'unavailable';
         if (placements.length === 0 || placements.every((placement) => placement.state === 'notInstalled')) {
             return 'notInstalled';
         }
         return placements.some((placement) => placement.state === 'scopeConflict'
-            || (placement.state === 'installed' && placement.health !== 'ready'))
+            || (placement.state === 'installed'
+                && (placement.health !== 'ready' || placement.blockingReason !== undefined)))
             ? 'needsAttention'
             : 'ready';
     };
@@ -359,6 +435,13 @@ async function loadDependencyOverviews(options) {
             title: '依赖关系需要处理',
             explanation: '当前目标的依赖证据不能安全通过检查。',
         })));
+        const consumerTargets = summaryById.get(pluginId)?.supportedTargets;
+        const unsupportedDependency = dependencyItems.find((dependency) => {
+            const dependencyTargets = summaryById.get(dependency.pluginId)?.supportedTargets;
+            if (!consumerTargets || !dependencyTargets)
+                return true;
+            return ['codex', 'claude'].some((platform) => consumerTargets[platform].length > 0 && dependencyTargets[platform].length === 0);
+        });
         const sourceId = parsePluginId(pluginId).sourceId;
         const blockers = [
             ...graph.sourceErrors.filter((error) => error.sourceId === sourceId).map((error) => ({
@@ -371,6 +454,11 @@ async function loadDependencyOverviews(options) {
                     title: '依赖关系无效',
                     explanation: '依赖关系形成环。',
                 }] : []),
+            ...(unsupportedDependency ? [{
+                    code: 'dependencyTargetUnsupported',
+                    title: '依赖目标不兼容',
+                    explanation: `${unsupportedDependency.displayName} 不支持根插件所需的平台。`,
+                }] : []),
             ...targetBlockers,
         ];
         const directCount = dependencyItems.filter((item) => item.relation === 'direct').length;
@@ -418,40 +506,105 @@ function createReviewStageReporter(options) {
     };
 }
 export function createTuiControllerDependencies(context, progressFeed, options = {}) {
+    const readInventory = options.inventoryCatalogSourceReferences
+        ?? inventoryCatalogSourceReferences;
+    const validatedStoreEntries = new Map();
+    const validatingStoreEntries = new Map();
+    const loadCatalogGenerations = async () => {
+        const generations = await loadCatalogGenerationViewModels({
+            env: context.env,
+            validatedStoreEntries,
+            validatingStoreEntries,
+            onStage: (event) => context.debugLogger.log({
+                type: 'performance:stage',
+                level: 'debug',
+                target: 'debugLog',
+                message: 'Catalog generation load stage completed.',
+                data: event,
+            }),
+        });
+        const retained = new Set(generations.flatMap((source) => [
+            source.active?.storeKey,
+        ].filter((value) => value !== undefined)));
+        for (const storeKey of validatedStoreEntries.keys()) {
+            if (!retained.has(storeKey))
+                validatedStoreEntries.delete(storeKey);
+        }
+        return generations;
+    };
+    const createOperationInventoryReader = () => {
+        let ordinaryInventory;
+        return (inventoryOptions) => {
+            if (inventoryOptions.includeHistoricalProjects === true) {
+                return readInventory(inventoryOptions);
+            }
+            ordinaryInventory ??= readInventory(inventoryOptions);
+            return ordinaryInventory;
+        };
+    };
+    const catalogOperationByEvidence = new WeakMap();
+    let sessionCatalogOperationContext;
+    let sessionStatusResult;
+    const sessionContextForPlugin = (pluginId) => {
+        const sourceId = parsePluginId(pluginId).sourceId;
+        if (!sourceId || !sessionCatalogOperationContext)
+            return undefined;
+        return selectCatalogOperationContext(sessionCatalogOperationContext, [sourceId]);
+    };
     const loadStatus = async (signal) => {
         signal.throwIfAborted();
         const packageInfo = await readCliPackageInfo();
+        const catalogOperationContext = sessionCatalogOperationContext
+            ?? await resolvePartialCatalogOperationContext({
+                env: context.env,
+                signal,
+                validatedStoreEntries,
+                validatingStoreEntries,
+            }).catch(() => undefined);
+        if (catalogOperationContext)
+            sessionCatalogOperationContext = catalogOperationContext;
         for (let attempt = 0; attempt < 3; attempt += 1) {
-            const result = await statusCommandV4({
+            const result = await statusCommandV6({
                 cwd: context.cwd,
                 env: context.env,
                 cliVersion: packageInfo.version,
                 verbose: context.diagnostics.verbose,
+                ...(catalogOperationContext ? { catalogOperationContext } : {}),
+                inventoryCatalogSourceReferences: readInventory,
             });
             signal.throwIfAborted();
             const configured = await listCatalogSources({ env: context.env });
             signal.throwIfAborted();
             if (result.payload.catalog.configDigest !== configured.configDigest)
                 continue;
+            sessionStatusResult = result;
             const dependencyOverviews = await loadDependencyOverviews({
                 context,
                 cliVersion: packageInfo.version,
                 status: result,
                 signal,
+                ...(catalogOperationContext ? { catalogOperationContext } : {}),
             });
             const portablePluginIds = await loadPortablePluginIds({
                 context,
                 cliVersion: packageInfo.version,
                 signal,
+                ...(catalogOperationContext ? { catalogOperationContext } : {}),
             });
             signal.throwIfAborted();
+            const catalogGenerations = await loadCatalogGenerations();
+            signal.throwIfAborted();
             const statusById = new Map(result.payload.catalog.sources.map((source) => [source.id, source]));
             return {
+                cliChannel: packageInfo.version.includes('-') ? 'beta' : 'latest',
                 payload: result.payload,
                 pluginSummaries: result.pluginSummaries,
                 targetRevisions: result.targetRevisions,
                 dependencyOverviews,
                 portablePluginIds,
+                catalogGenerations,
+                sessionGenerationKeys: Object.fromEntries((catalogOperationContext?.generationSet.sources ?? [])
+                    .map((source) => [source.sourceId, source.storeKey])),
                 sourceDetails: configured.sources.map((source) => {
                     const status = statusById.get(source.id);
                     return {
@@ -479,7 +632,7 @@ export function createTuiControllerDependencies(context, progressFeed, options =
         }
         throw new TuiOperationBlockedError('operationReviewStale', '状态读取期间来源配置持续变化。请重试。');
     };
-    const captureEvidence = async (intent, signal, freshnessPolicy = 'cacheFirst', preparation) => {
+    const captureEvidence = async (intent, signal, preparation, operationInventory = createOperationInventoryReader(), freshCatalog = false) => {
         if (intent.kind === 'sourceMutation') {
             signal?.throwIfAborted();
             if (intent.action === 'add' && !intent.source
@@ -501,10 +654,10 @@ export function createTuiControllerDependencies(context, progressFeed, options =
             await preparation?.reporter.emit('evidence');
             signal?.throwIfAborted();
             const evidence = {
-                catalog: { configDigest: preview.configDigest, compositeDigest: preview.candidateDigest },
+                catalog: { configDigest: preview.configDigest, compositeDigest: preview.proposedConfigDigest },
                 sourceWrite: {
                     configDigest: preview.configDigest,
-                    candidateDigest: preview.candidateDigest,
+                    proposedConfigDigest: preview.proposedConfigDigest,
                     ...(preview.sourceIdentity ? { sourceIdentity: preview.sourceIdentity } : {}),
                     inventoryDigest: digest({ references: preview.references.references, errors: preview.references.errors }),
                     referenceCount: preview.references.references.length,
@@ -512,7 +665,7 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 },
             };
             if (preparation?.validateIntent
-                && evidence.sourceWrite?.configDigest === evidence.sourceWrite?.candidateDigest) {
+                && evidence.sourceWrite?.configDigest === evidence.sourceWrite?.proposedConfigDigest) {
                 throw new TuiOperationBlockedError('sourceNoChanges', '来源没有变化。');
             }
             return evidence;
@@ -522,8 +675,37 @@ export function createTuiControllerDependencies(context, progressFeed, options =
         }
         signal?.throwIfAborted();
         const packageInfo = await readCliPackageInfo();
+        const offlineCleanupReason = intent.kind === 'pluginWrite'
+            && intent.action === 'cleanup'
+            && intent.originIssue?.actionId === 'cleanup'
+            && (intent.originIssue?.category === 'sourceMissing'
+                || intent.originIssue?.category === 'sourceUnavailable')
+            ? intent.originIssue.category === 'sourceMissing' ? 'sourceMissing' : 'bundleUnavailable'
+            : undefined;
+        let catalogOperation;
+        let catalogOperationError;
+        if (!offlineCleanupReason && intent.kind !== 'portableInstall') {
+            try {
+                const sourceIds = [parsePluginId(intent.pluginId).sourceId];
+                catalogOperation = !freshCatalog && sessionCatalogOperationContext
+                    ? selectCatalogOperationContext(sessionCatalogOperationContext, sourceIds)
+                    : await resolveCatalogOperationContext({
+                        sourceIds,
+                        env: context.env,
+                        ...(!freshCatalog ? { validatedStoreEntries, validatingStoreEntries } : {}),
+                        ...(signal ? { signal } : {}),
+                    });
+            }
+            catch (error) {
+                catalogOperationError = error;
+            }
+        }
         if (intent.kind === 'portableInstall') {
             await preparation?.reporter.emit('portable');
+            const portableSourceId = parsePluginId(intent.pluginId).sourceId;
+            const portableCatalogOperation = sessionCatalogOperationContext
+                ? selectCatalogOperationContext(sessionCatalogOperationContext, [portableSourceId])
+                : undefined;
             const portable = await preparePortableInstall({
                 selector: intent.pluginId,
                 scope: intent.scope,
@@ -533,20 +715,105 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 env: context.env,
                 cliVersion: packageInfo.version,
                 signal,
+                ...(portableCatalogOperation
+                    ? { catalogOperationContext: portableCatalogOperation }
+                    : {}),
             });
             signal?.throwIfAborted();
             await preparation?.reporter.emit('evidence');
             signal?.throwIfAborted();
-            return {
+            const evidence = {
                 catalog: {
                     configDigest: portable.configDigest,
                     compositeDigest: portable.evidenceDigest,
+                    ...(portable.generationSetDigest
+                        ? { generationSetDigest: portable.generationSetDigest }
+                        : {}),
                 },
                 portable,
             };
+            if (catalogOperation)
+                catalogOperationByEvidence.set(evidence, catalogOperation);
+            return evidence;
+        }
+        if (preparation && (intent.kind === 'configSave' || intent.kind === 'configReset')) {
+            if (!sessionStatusResult || !catalogOperation) {
+                throw operationReviewStale('当前 TUI session 没有可复用的设置证据。');
+            }
+            await preparation.reporter.emit('config');
+            const configSnapshot = await readCatalogSourcesConfigSnapshot(context.env);
+            signal?.throwIfAborted();
+            if (configSnapshot.digest !== sessionStatusResult.payload.catalog.configDigest) {
+                throw operationReviewStale('准备设置确认期间来源配置发生变化。');
+            }
+            const selected = await withResolvedCatalogPlugin({
+                selector: intent.pluginId,
+                cliVersion: packageInfo.version,
+                configSnapshot,
+                env: context.env,
+                operationContext: catalogOperation,
+                ...(signal ? { signal } : {}),
+                consume: async ({ plugin, source }) => {
+                    if (!plugin.manifest.config) {
+                        throw new TuiOperationBlockedError('configSchemaUnavailable', '这个插件没有设置 schema。');
+                    }
+                    if (intent.kind === 'configSave') {
+                        await coercePluginConfigUpdates({
+                            schema: plugin.manifest.config.schema,
+                            updates: intent.updates ?? {},
+                            cwd: context.cwd,
+                        });
+                        for (const key of intent.removeKeys ?? []) {
+                            if (!plugin.manifest.config.schema[key]) {
+                                throw new TuiOperationBlockedError('unknownConfigKey', '设置字段已变化，请重新检查。');
+                            }
+                        }
+                    }
+                    return {
+                        pluginName: plugin.manifest.name,
+                        source: sourceEvidenceForPlugin(source, plugin.manifest.name),
+                    };
+                },
+            });
+            const store = await readPluginConfigStore({
+                sourceId: selected.source.sourceId,
+                sourceIdentity: selected.source.sourceIdentity,
+                pluginName: selected.pluginName,
+                scope: intent.scope,
+                projectLayer: intent.projectLayer,
+                cwd: context.cwd,
+                env: context.env,
+            });
+            signal?.throwIfAborted();
+            const relevantTargets = configAffectedStatusTargets(sessionStatusResult.payload.targets, intent.pluginId, intent.scope);
+            const relevantRevisions = (sessionStatusResult.targetRevisions ?? []).filter((revision) => relevantTargets.some((target) => target.platform === revision.platform
+                && target.scope === revision.scope
+                && target.pluginId === revision.pluginId));
+            await preparation.reporter.emit('evidence');
+            const evidence = {
+                catalog: {
+                    configDigest: sessionStatusResult.payload.catalog.configDigest,
+                    compositeDigest: sessionStatusResult.payload.catalog.compositeDigest,
+                    generationSetDigest: catalogOperation.generationSetDigest,
+                },
+                source: selected.source,
+                targetFingerprint: statusTargetFingerprint(relevantTargets, relevantRevisions),
+                config: {
+                    scope: intent.scope,
+                    projectLayer: intent.projectLayer,
+                    schemaIdentity: selected.source.manifestDigest,
+                    storeDigest: digest({ exists: store.exists, values: store.values }),
+                    affectedTargets: relevantTargets.map(({ platform, scope }) => ({ platform, scope })),
+                },
+            };
+            catalogOperationByEvidence.set(evidence, catalogOperation);
+            return evidence;
         }
         await preparation?.reporter.emit('status');
-        const status = await statusCommandV4({
+        const statusCatalogOperation = offlineCleanupReason
+            ? undefined
+            : catalogOperation ?? (!freshCatalog ? sessionCatalogOperationContext : undefined);
+        const status = await statusCommandV6({
             plugins: [...new Set([intent.pluginId,
                     ...(intent.kind === 'pluginWrite' && intent.originIssue?.consumerPluginId
                         ? [intent.originIssue.consumerPluginId] : [])])],
@@ -557,39 +824,72 @@ export function createTuiControllerDependencies(context, progressFeed, options =
             cwd: context.cwd,
             env: context.env,
             cliVersion: packageInfo.version,
+            ...(statusCatalogOperation ? { catalogOperationContext: statusCatalogOperation } : {}),
+            inventoryCatalogSourceReferences: operationInventory,
         });
         signal?.throwIfAborted();
+        const configSnapshot = await readCatalogSourcesConfigSnapshot(context.env);
+        signal?.throwIfAborted();
+        if (configSnapshot.digest !== status.payload.catalog.configDigest) {
+            throw operationReviewStale('准备确认信息期间来源配置发生变化。');
+        }
+        if (catalogOperationError)
+            throw catalogOperationError;
         if (intent.kind === 'pluginWrite') {
             await assertTypedIssueOrigin(intent, status.payload.targets);
             if (preparation?.validateIntent) {
                 assertIntentIsLegal(intent, status.payload.targets, status.targetRevisions);
             }
         }
-        const configSnapshot = await readCatalogSourcesConfigSnapshot(context.env);
-        signal?.throwIfAborted();
-        if (configSnapshot.digest !== status.payload.catalog.configDigest) {
-            throw operationReviewStale('准备确认信息期间来源配置发生变化。');
+        if (!offlineCleanupReason && !catalogOperation) {
+            catalogOperation = await resolveCatalogOperationContext({
+                sourceIds: [parsePluginId(intent.pluginId).sourceId],
+                configSnapshot,
+                env: context.env,
+                ...(!freshCatalog ? { validatedStoreEntries, validatingStoreEntries } : {}),
+                ...(signal ? { signal } : {}),
+            });
         }
         let dependencyPlan;
+        let codexReconcilePlans;
         await preparation?.reporter.emit('catalog');
-        const bundleUnavailableCleanupTarget = intent.kind === 'pluginWrite'
-            && intent.action === 'cleanup'
-            && intent.originIssue?.category === 'sourceUnavailable'
-            && intent.originIssue.actionId === 'cleanup'
+        const offlineCleanupTarget = offlineCleanupReason && intent.kind === 'pluginWrite'
             ? status.payload.targets.find((target) => target.pluginId === intent.pluginId
                 && target.platform === intent.platform
                 && target.scope === intent.scope
-                && target.errors.some((error) => error.code === 'bundleUnavailable'))
+                && target.errors.some((error) => error.code === offlineCleanupReason))
             : undefined;
-        const catalogSource = bundleUnavailableCleanupTarget
-            ? status.payload.catalog.sources.find((source) => source.id === bundleUnavailableCleanupTarget.sourceId)
+        const catalogSource = offlineCleanupTarget
+            ? status.payload.catalog.sources.find((source) => source.id === offlineCleanupTarget.sourceId)
             : undefined;
-        const selected = bundleUnavailableCleanupTarget
+        let offlineCleanup;
+        if (offlineCleanupReason && offlineCleanupTarget) {
+            await preparation?.reporter.emit('inventory');
+            const inventory = await operationInventory({
+                cwd: context.cwd,
+                env: context.env,
+            });
+            signal?.throwIfAborted();
+            offlineCleanup = offlineCleanupEvidenceFromInventory({
+                reason: offlineCleanupReason,
+                pluginId: offlineCleanupTarget.pluginId,
+                pluginName: offlineCleanupTarget.pluginName,
+                sourceId: offlineCleanupTarget.sourceId,
+                sourceIdentity: offlineCleanupTarget.sourceIdentity,
+                platform: offlineCleanupTarget.platform,
+                scope: offlineCleanupTarget.scope,
+                inventory,
+            }) ?? undefined;
+            if (!offlineCleanup) {
+                throw operationReviewStale('离线清理现场证据已消失或无法验证。');
+            }
+        }
+        const selected = offlineCleanupTarget
             ? {
-                pluginName: bundleUnavailableCleanupTarget.pluginName,
+                pluginName: offlineCleanupTarget.pluginName,
                 source: {
-                    sourceId: bundleUnavailableCleanupTarget.sourceId,
-                    sourceIdentity: bundleUnavailableCleanupTarget.sourceIdentity,
+                    sourceId: offlineCleanupTarget.sourceId,
+                    sourceIdentity: offlineCleanupTarget.sourceIdentity,
                     ...(catalogSource?.requestedRef ? { requestedRef: catalogSource.requestedRef } : {}),
                     ...(catalogSource?.resolvedCommit ? { resolvedCommit: catalogSource.resolvedCommit } : {}),
                 },
@@ -597,9 +897,9 @@ export function createTuiControllerDependencies(context, progressFeed, options =
             : await withResolvedCatalogPlugin({
                 selector: intent.pluginId,
                 cliVersion: packageInfo.version,
-                freshnessPolicy,
                 configSnapshot,
                 env: context.env,
+                ...(catalogOperation ? { operationContext: catalogOperation } : {}),
                 ...(signal ? { signal } : {}),
                 consume: async ({ plugin, source }) => {
                     if (preparation?.validateIntent && intent.kind === 'configSave') {
@@ -624,48 +924,112 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                     };
                 },
             });
+        let codexManager;
         const hasDeclaredDependencies = (status.pluginSummaries.find((summary) => summary.pluginId === intent.pluginId)?.dependencyTotalCount ?? 0) > 0;
-        if (intent.kind === 'pluginWrite'
-            && hasDeclaredDependencies
-            && (intent.action === 'install' || intent.action === 'upgrade' || intent.action === 'reinstall')) {
+        if (intent.kind === 'pluginWrite') {
             const command = {
                 install: installWriteCommand,
                 upgrade: upgradeWriteCommand,
                 reinstall: reinstallWriteCommand,
+                uninstall: uninstallWriteCommand,
+                cleanup: cleanupWriteCommand,
+                sync: installWriteCommand,
             }[intent.action];
             const preview = await command([intent.pluginId], {
                 cwd: context.cwd,
                 platform: intent.platform,
                 scope: intent.scope,
+                ...(intent.action === 'install' && intent.dependencyScopeOverrides
+                    ? { dependencyScopeOverrides: intent.dependencyScopeOverrides }
+                    : {}),
+                ...(intent.action === 'cleanup' ? { force: intent.force === true } : {}),
             }, {
                 ...context,
+                inventoryCatalogSourceReferences: operationInventory,
                 expectedCatalogConfigDigest: status.payload.catalog.configDigest,
+                ...(catalogOperation ? {
+                    catalogOperationContext: catalogOperation,
+                    expectedGenerationSetDigest: catalogOperation.generationSetDigest,
+                } : {}),
                 previewDependencyPlanOnly: true,
+                ...(intent.action === 'sync' ? { reconcileIntentOnly: true } : {}),
                 ...(preparation ? {
-                    previewCatalogFreshnessPolicy: 'cacheFirst',
                     onPreviewStage: (stage) => stage === 'catalog' ? undefined : preparation.reporter.emit(stage),
                 } : {}),
             });
             signal?.throwIfAborted();
-            dependencyPlan = preview.dependencyPlan;
-            if (!dependencyPlan) {
-                throw new TuiOperationBlockedError('dependencyGraphInvalid', '无法建立可信的依赖安装计划。');
+            codexReconcilePlans = intent.dependencyPlacementOnly === 'desired'
+                ? undefined
+                : preview?.codexReconcilePlans;
+            if (hasDeclaredDependencies
+                && (intent.action === 'install'
+                    || intent.action === 'upgrade'
+                    || intent.action === 'reinstall'
+                    || intent.action === 'sync')) {
+                dependencyPlan = preview.dependencyPlan;
+                if (!dependencyPlan) {
+                    throw new TuiOperationBlockedError('dependencyGraphInvalid', '无法建立可信的依赖安装计划。');
+                }
+                const blocker = dependencyPlan.targets.find((target) => target.action === 'block');
+                if (blocker) {
+                    throw new TuiOperationBlockedError(blocker.errorCode ?? 'dependencyNotReady', `${blocker.errorCode ?? 'dependencyNotReady'}: 依赖安装计划被阻止。`);
+                }
             }
-            const blocker = dependencyPlan.targets.find((target) => target.action === 'block');
-            if (blocker) {
-                throw new TuiOperationBlockedError(blocker.errorCode ?? 'dependencyNotReady', `${blocker.errorCode ?? 'dependencyNotReady'}: 依赖安装计划被阻止。`);
+            const managerPreview = preview?.codexManagerPreview;
+            if (managerPreview?.state === 'blocked' && intent.dependencyPlacementOnly !== 'desired') {
+                const message = managerPreview.code === 'codexSystemCliUnsupported'
+                    ? '系统 Codex CLI 版本不受支持。请升级官方 Codex CLI 后重试。'
+                    : 'AW-managed Codex runtime 当前不可用。请重试、升级 AW，或安装官方 Codex CLI。';
+                throw new TuiOperationBlockedError(managerPreview.code, `${managerPreview.code}: ${message}`);
+            }
+            if (managerPreview && managerPreview.state !== 'blocked'
+                && intent.dependencyPlacementOnly !== 'desired') {
+                codexManager = {
+                    state: managerPreview.state,
+                    packageName: MANAGED_CODEX_PACKAGE_NAME,
+                    version: managerPreview.state === 'requires-install'
+                        ? MANAGED_CODEX_VERSION
+                        : managerPreview.manager.version,
+                };
             }
         }
         await preparation?.reporter.emit('evidence');
         signal?.throwIfAborted();
+        let projectIntentDigest;
+        if (intent.kind === 'pluginWrite' && intent.dependencyPlacementOnly === 'desired') {
+            if (intent.scope !== 'project') {
+                throw new TuiOperationBlockedError('dependencyPlacementScopeInvalid', '缩小依赖位置只能更新当前项目 desired intent。');
+            }
+            projectIntentDigest = calculatePluginIntentDigest(await readPluginIntentState({
+                scope: 'project',
+                cwd: context.cwd,
+                env: context.env,
+            }));
+            signal?.throwIfAborted();
+        }
+        const evidenceTargets = intent.kind === 'configSave' || intent.kind === 'configReset'
+            ? configAffectedStatusTargets(status.payload.targets, intent.pluginId, intent.scope)
+            : status.payload.targets;
+        const evidenceRevisions = intent.kind === 'configSave' || intent.kind === 'configReset'
+            ? (status.targetRevisions ?? []).filter((revision) => evidenceTargets.some((target) => target.platform === revision.platform
+                && target.scope === revision.scope
+                && target.pluginId === revision.pluginId))
+            : (status.targetRevisions ?? []);
         const evidence = {
             catalog: {
                 configDigest: status.payload.catalog.configDigest,
                 compositeDigest: status.payload.catalog.compositeDigest,
+                ...(catalogOperation
+                    ? { generationSetDigest: catalogOperation.generationSetDigest }
+                    : {}),
             },
             source: selected.source,
+            ...(offlineCleanup ? { offlineCleanup } : {}),
             ...(dependencyPlan ? { dependencyPlan } : {}),
-            targetFingerprint: statusTargetFingerprint(status.payload.targets, status.targetRevisions ?? []),
+            ...(projectIntentDigest ? { projectIntentDigest } : {}),
+            ...(codexReconcilePlans ? { codexReconcilePlans } : {}),
+            ...(codexManager ? { codexManager } : {}),
+            targetFingerprint: statusTargetFingerprint(evidenceTargets, evidenceRevisions),
         };
         if (intent.kind === 'configSave' || intent.kind === 'configReset') {
             const store = await readPluginConfigStore({
@@ -683,11 +1047,21 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 projectLayer: intent.projectLayer,
                 schemaIdentity: selected.source.manifestDigest,
                 storeDigest: digest({ exists: store.exists, values: store.values }),
+                affectedTargets: evidenceTargets.map(({ platform, scope }) => ({ platform, scope })),
             };
         }
+        if (catalogOperation)
+            catalogOperationByEvidence.set(evidence, catalogOperation);
         return evidence;
     };
     const dependencies = {
+        beginCatalogSession(sessionOptions) {
+            sessionCatalogOperationContext = undefined;
+            if (sessionOptions?.reuseValidatedGenerations !== true) {
+                validatedStoreEntries.clear();
+                validatingStoreEntries.clear();
+            }
+        },
         loadStatus,
         async inspectSourceRemoval(_sourceId, signal) {
             signal.throwIfAborted();
@@ -708,7 +1082,7 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 now: options.now ?? Date.now,
             });
             try {
-                return await captureEvidence(intent, signal, 'cacheFirst', {
+                return await captureEvidence(intent, signal, {
                     reporter,
                     validateIntent: true,
                 });
@@ -717,10 +1091,14 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 await reporter.finish();
             }
         },
+        async previewDependencyPlacement(intent, signal) {
+            const evidence = await captureEvidence(intent, signal);
+            return evidence.dependencyPlan;
+        },
         async validateIntent(intent, signal) {
             if (intent.kind === 'sourceMutation') {
                 const evidence = await captureEvidence(intent, signal);
-                if (evidence.sourceWrite?.configDigest === evidence.sourceWrite?.candidateDigest) {
+                if (evidence.sourceWrite?.configDigest === evidence.sourceWrite?.proposedConfigDigest) {
                     throw new TuiOperationBlockedError('sourceNoChanges', '来源没有变化。');
                 }
                 return;
@@ -730,9 +1108,11 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 await withResolvedCatalogPlugin({
                     selector: intent.pluginId,
                     cliVersion: packageInfo.version,
-                    freshnessPolicy: 'cacheFirst',
                     env: context.env,
                     signal,
+                    ...(sessionContextForPlugin(intent.pluginId)
+                        ? { operationContext: sessionContextForPlugin(intent.pluginId) }
+                        : {}),
                     consume: async ({ plugin }) => {
                         if (!plugin.manifest.config) {
                             throw new TuiOperationBlockedError('configSchemaUnavailable', '这个插件没有设置 schema。');
@@ -755,39 +1135,53 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                 return;
             signal.throwIfAborted();
             const packageInfo = await readCliPackageInfo();
-            const status = await statusCommandV4({
-                plugins: [...new Set([intent.pluginId,
-                        ...(intent.originIssue?.consumerPluginId ? [intent.originIssue.consumerPluginId] : [])])],
+            const pluginIds = [...new Set([intent.pluginId,
+                    ...(intent.originIssue?.consumerPluginId ? [intent.originIssue.consumerPluginId] : [])])];
+            const offlineCleanup = intent.action === 'cleanup'
+                && intent.originIssue?.actionId === 'cleanup'
+                && (intent.originIssue.category === 'sourceMissing'
+                    || intent.originIssue.category === 'sourceUnavailable');
+            const sourceIds = pluginIds.map((pluginId) => parsePluginId(pluginId).sourceId);
+            let catalogOperation = offlineCleanup
+                ? undefined
+                : sessionCatalogOperationContext
+                    ? selectCatalogOperationContext(sessionCatalogOperationContext, sourceIds)
+                    : undefined;
+            const statusOptions = {
+                plugins: pluginIds,
                 platform: intent.platform,
                 cwd: context.cwd,
                 env: context.env,
                 cliVersion: packageInfo.version,
+                inventoryCatalogSourceReferences: readInventory,
+            };
+            let status = await statusCommandV6({
+                ...statusOptions,
+                ...(catalogOperation ? { catalogOperationContext: catalogOperation } : {}),
             });
+            const platforms = intent.platform === 'both'
+                ? ['codex', 'claude']
+                : [intent.platform];
+            const missingSelectedTarget = platforms.some((platform) => !status.payload.targets.some((target) => target.pluginId === intent.pluginId
+                && target.platform === platform
+                && (platform === 'codex' || target.scope === intent.scope)));
+            if (!offlineCleanup && !catalogOperation && missingSelectedTarget) {
+                catalogOperation = await resolveCatalogOperationContext({
+                    sourceIds,
+                    env: context.env,
+                    validatedStoreEntries,
+                    validatingStoreEntries,
+                    signal,
+                });
+                status = await statusCommandV6({
+                    ...statusOptions,
+                    catalogOperationContext: catalogOperation,
+                });
+            }
             signal.throwIfAborted();
             await assertTypedIssueOrigin(intent, status.payload.targets);
             assertIntentIsLegal(intent, status.payload.targets, status.targetRevisions);
         },
-        async checkSource(sourceId, signal) {
-            const packageInfo = await readCliPackageInfo();
-            const configSnapshot = await readCatalogSourcesConfigSnapshot(context.env);
-            return withResolvedMultiSourceCatalog({
-                cliVersion: packageInfo.version,
-                freshnessPolicy: 'forceRemote',
-                sourceIds: [sourceId],
-                configSnapshot,
-                env: context.env,
-                signal,
-                consume: (catalog) => {
-                    const item = catalog.sources[0];
-                    if (item.error)
-                        throw item.error;
-                    return {
-                        sourceIdentity: item.resolution.sourceIdentity,
-                        requestedRef: item.resolution.requestedRef,
-                    };
-                },
-            });
-        },
         captureEvidence,
         logError(_error, code, logContext) {
             return context.debugLogger.log({
@@ -805,9 +1199,11 @@ export function createTuiControllerDependencies(context, progressFeed, options =
             return withResolvedCatalogPlugin({
                 selector: pluginId,
                 cliVersion: packageInfo.version,
-                freshnessPolicy: 'cacheFirst',
                 env: context.env,
                 signal,
+                ...(sessionContextForPlugin(pluginId)
+                    ? { operationContext: sessionContextForPlugin(pluginId) }
+                    : {}),
                 consume: async ({ plugin }) => {
                     if (!plugin.manifest.config) {
                         throw new TuiOperationBlockedError('configSchemaUnavailable', '这个插件没有设置 schema。');
@@ -837,9 +1233,11 @@ export function createTuiControllerDependencies(context, progressFeed, options =
             return withResolvedCatalogPlugin({
                 selector: pluginId,
                 cliVersion: packageInfo.version,
-                freshnessPolicy: 'cacheFirst',
                 env: context.env,
                 signal,
+                ...(sessionContextForPlugin(pluginId)
+                    ? { operationContext: sessionContextForPlugin(pluginId) }
+                    : {}),
                 consume: async ({ plugin }) => {
                     if (!plugin.manifest.config) {
                         throw new TuiOperationBlockedError('configSchemaUnavailable', '这个插件没有设置 schema。');
@@ -860,7 +1258,39 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                         cwd: context.cwd,
                         env: context.env,
                     });
-                    return buildConfigPage({ pluginId, schema: plugin.manifest.config, read, effectiveRead });
+                    const layerReads = layer.scope === 'effective' ? undefined : {
+                        user: await resolveConfigRead({
+                            pluginName: plugin.manifest.name,
+                            plugin,
+                            scope: 'user',
+                            projectLayer: 'shared',
+                            cwd: context.cwd,
+                            env: context.env,
+                        }),
+                        project: await resolveConfigRead({
+                            pluginName: plugin.manifest.name,
+                            plugin,
+                            scope: 'project',
+                            projectLayer: 'shared',
+                            cwd: context.cwd,
+                            env: context.env,
+                        }),
+                        local: await resolveConfigRead({
+                            pluginName: plugin.manifest.name,
+                            plugin,
+                            scope: 'project',
+                            projectLayer: 'local',
+                            cwd: context.cwd,
+                            env: context.env,
+                        }),
+                    };
+                    return buildConfigPage({
+                        pluginId,
+                        schema: plugin.manifest.config,
+                        read,
+                        effectiveRead,
+                        ...(layerReads ? { layerReads } : {}),
+                    });
                 },
             });
         },
@@ -920,6 +1350,7 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                         env: context.env,
                         cliVersion: packageInfo.version,
                         expectedEvidenceDigest: expectedEvidence.portable.evidenceDigest,
+                        expectedGenerationSetDigest: expectedEvidence.catalog.generationSetDigest,
                         onProgress(stage) {
                             const phase = stage === 'prepare' ? '检查插件依赖并生成候选'
                                 : stage === 'add' ? '安装已选择的 Skills' : '验证安装结果';
@@ -934,49 +1365,87 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                     throw error;
                 }
             }
+            if (intent.kind === 'sourceMutation') {
+                const currentEvidence = await captureEvidence(intent);
+                if (operationEvidenceFingerprint(currentEvidence) !== operationEvidenceFingerprint(expectedEvidence)) {
+                    throw new TuiOperationBlockedError('operationReviewStale', '确认后状态发生变化。');
+                }
+                await tuiControllerRuntimeTestHooks?.afterMutationEvidenceCapture?.();
+                const packageInfo = await readCliPackageInfo();
+                const runtime = {
+                    onProgress: async (event) => {
+                        const phase = SOURCE_PROGRESS_PHASES[event.stage];
+                        progressFeed?.setCurrent({ target: 'Catalog 来源配置', phase }, `来源操作：${phase}`);
+                        await tuiControllerRuntimeTestHooks?.onCatalogSourceProgress?.(event);
+                    },
+                };
+                const common = {
+                    cwd: context.cwd,
+                    env: context.env,
+                    expectedConfigDigest: expectedEvidence.sourceWrite?.configDigest,
+                    runtime,
+                };
+                if (intent.action === 'add' && intent.source) {
+                    return addCatalogSourceCommand({ ...common, source: intent.source, cliVersion: packageInfo.version });
+                }
+                if (intent.action === 'update' && intent.update) {
+                    return updateCatalogSourceCommand({ ...common, sourceId: intent.sourceId, update: intent.update, cliVersion: packageInfo.version });
+                }
+                if (intent.action === 'setPrimary') {
+                    return setPrimaryCatalogSourceCommand({ ...common, sourceId: intent.sourceId });
+                }
+                if (intent.action === 'remove') {
+                    return removeCatalogSourceCommand({ ...common, sourceId: intent.sourceId });
+                }
+                throw new TuiOperationBlockedError('invalidSourceMutation', '来源操作缺少候选输入。');
+            }
             return withAwHomeMutationLock({
                 env: context.env,
                 action: async (awHomeMutationToken) => {
-                    const currentEvidence = await captureEvidence(intent, undefined, 'requireRemote');
+                    await tuiControllerRuntimeTestHooks?.beforeMutationEvidenceCapture?.();
+                    const operationInventory = createOperationInventoryReader();
+                    const currentEvidence = await captureEvidence(intent, undefined, undefined, operationInventory, true);
                     if (operationEvidenceFingerprint(currentEvidence) !== operationEvidenceFingerprint(expectedEvidence)) {
                         throw new TuiOperationBlockedError('operationReviewStale', '确认后状态发生变化。');
                     }
-                    await tuiControllerRuntimeTestHooks?.afterMutationEvidenceCapture?.();
-                    if (intent.kind === 'sourceMutation') {
-                        const packageInfo = await readCliPackageInfo();
-                        const runtime = {
-                            awHomeMutationToken,
-                            onProgress: async (event) => {
-                                const phase = SOURCE_PROGRESS_PHASES[event.stage];
-                                progressFeed?.setCurrent({ target: 'Catalog 来源配置', phase }, `来源操作：${phase}`);
-                                await tuiControllerRuntimeTestHooks?.onCatalogSourceProgress?.(event);
-                            },
-                        };
-                        const common = {
-                            cwd: context.cwd,
-                            env: context.env,
-                            expectedConfigDigest: expectedEvidence.sourceWrite?.configDigest,
-                            runtime,
-                        };
-                        if (intent.action === 'add' && intent.source) {
-                            return addCatalogSourceCommand({ ...common, source: intent.source, cliVersion: packageInfo.version });
-                        }
-                        if (intent.action === 'update' && intent.update) {
-                            return updateCatalogSourceCommand({ ...common, sourceId: intent.sourceId, update: intent.update, cliVersion: packageInfo.version });
-                        }
-                        if (intent.action === 'setPrimary') {
-                            return setPrimaryCatalogSourceCommand({ ...common, sourceId: intent.sourceId });
-                        }
-                        if (intent.action === 'remove') {
-                            return removeCatalogSourceCommand({ ...common, sourceId: intent.sourceId });
-                        }
-                        throw new TuiOperationBlockedError('invalidSourceMutation', '来源操作缺少候选输入。');
+                    const catalogOperation = catalogOperationByEvidence.get(currentEvidence);
+                    if (expectedEvidence.catalog.generationSetDigest
+                        && catalogOperation?.generationSetDigest !== expectedEvidence.catalog.generationSetDigest) {
+                        throw operationReviewStale('确认后 Active Catalog generation 发生变化。');
                     }
+                    await tuiControllerRuntimeTestHooks?.afterMutationEvidenceCapture?.();
                     if (intent.kind === 'pluginWrite') {
+                        if (intent.dependencyPlacementOnly === 'desired') {
+                            const plan = currentEvidence.dependencyPlan;
+                            if (!plan || !expectedEvidence.projectIntentDigest) {
+                                throw operationReviewStale('确认信息缺少依赖位置或 project intent 证据。');
+                            }
+                            const location = { scope: 'project', cwd: context.cwd, env: context.env };
+                            const currentIntent = await readPluginIntentState(location);
+                            if (calculatePluginIntentDigest(currentIntent) !== expectedEvidence.projectIntentDigest) {
+                                throw operationReviewStale('确认后 project desired intent 发生变化。');
+                            }
+                            const plannedKeys = new Set(plan.targets.map((target) => `${target.pluginId}\0${target.platform}`));
+                            const nextIntent = canonicalizePluginIntentState({
+                                ...currentIntent,
+                                dependencyScopeOverrides: [
+                                    ...currentIntent.dependencyScopeOverrides.filter((override) => !plannedKeys.has(`${override.pluginId}\0${override.platform}`)),
+                                    ...plan.scopeOverrides,
+                                ],
+                            });
+                            await writePluginIntentState(location, nextIntent);
+                            return { dependencyPlan: plan, desiredPlacementUpdated: true };
+                        }
                         const options = {
                             cwd: context.cwd,
                             platform: intent.platform,
                             scope: intent.scope,
+                            ...(intent.action === 'install' && intent.dependencyScopeOverrides
+                                ? { dependencyScopeOverrides: intent.dependencyScopeOverrides }
+                                : {}),
+                            ...(expectedEvidence.codexManager?.state === 'requires-install'
+                                ? { allowManagedCodexInstall: true }
+                                : {}),
                             ...(intent.action === 'cleanup' ? { force: intent.force === true } : {}),
                         };
                         const command = {
@@ -985,16 +1454,35 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                             reinstall: reinstallWriteCommand,
                             uninstall: uninstallWriteCommand,
                             cleanup: cleanupWriteCommand,
+                            sync: installWriteCommand,
                         }[intent.action];
                         const currentSource = currentEvidence.source;
-                        if (!expectedEvidence.source || !currentSource) {
+                        const offlineCleanup = currentEvidence.offlineCleanup;
+                        if (!offlineCleanup && (!expectedEvidence.source || !currentSource)) {
                             throw new TuiOperationBlockedError('operationReviewStale', '确认信息缺少来源身份。');
                         }
                         const result = await command([intent.pluginId], options, {
                             ...context,
                             awHomeMutationToken,
+                            inventoryCatalogSourceReferences: operationInventory,
+                            ...(currentEvidence.dependencyPlan
+                                ? { expectedOperationDependencyPlan: currentEvidence.dependencyPlan }
+                                : {}),
+                            ...(currentEvidence.codexReconcilePlans
+                                ? { expectedCodexReconcilePlans: currentEvidence.codexReconcilePlans }
+                                : {}),
+                            ...(intent.action === 'sync' ? { reconcileIntentOnly: true } : {}),
                             expectedCatalogConfigDigest: expectedEvidence.catalog.configDigest,
-                            reviewPreflight: (actual) => assertSourceEvidenceMatches(currentSource, actual),
+                            ...(catalogOperation ? {
+                                catalogOperationContext: catalogOperation,
+                                expectedGenerationSetDigest: expectedEvidence.catalog.generationSetDigest,
+                            } : {}),
+                            ...(expectedEvidence.codexManager?.state === 'requires-install'
+                                ? { managedCodexAuthorizer: async () => true }
+                                : {}),
+                            ...(offlineCleanup
+                                ? { expectedOfflineCleanupEvidence: offlineCleanup }
+                                : { reviewPreflight: (actual) => assertSourceEvidenceMatches(currentSource, actual) }),
                         });
                         throwIfWriteReviewStale(result);
                         return result;
@@ -1008,10 +1496,15 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                         return withResolvedCatalogPlugin({
                             selector: intent.pluginId,
                             cliVersion: packageInfo.version,
-                            freshnessPolicy: 'requireRemote',
                             env: context.env,
+                            ...(catalogOperation ? { operationContext: catalogOperation } : {}),
                             consume: async ({ plugin, source }) => {
                                 assertSourceEvidenceMatches(currentSource, sourceEvidenceForPlugin(source, plugin.manifest.name));
+                                const applyTargets = currentEvidence.config?.affectedTargets.map((target) => ({
+                                    pluginName: plugin.manifest.name,
+                                    platform: target.platform,
+                                    scope: target.scope,
+                                })) ?? [];
                                 const result = intent.kind === 'configSave'
                                     ? await applyPluginConfigWrite({
                                         plugin,
@@ -1021,8 +1514,16 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                                         cwd: context.cwd,
                                         env: context.env,
                                         nativeCliRunner: context.nativeCliRunner,
-                                        rebuildRuntime: { ...context, awHomeMutationToken },
+                                        rebuildRuntime: {
+                                            ...context,
+                                            awHomeMutationToken,
+                                            ...(catalogOperation ? {
+                                                catalogOperationContext: catalogOperation,
+                                                expectedGenerationSetDigest: expectedEvidence.catalog.generationSetDigest,
+                                            } : {}),
+                                        },
                                         awHomeMutationToken,
+                                        applyTargets,
                                         request: { updates: intent.updates, removeKeys: intent.removeKeys },
                                     })
                                     : await resetPluginConfigWithHelper({
@@ -1033,8 +1534,16 @@ export function createTuiControllerDependencies(context, progressFeed, options =
                                         cwd: context.cwd,
                                         env: context.env,
                                         nativeCliRunner: context.nativeCliRunner,
-                                        rebuildRuntime: { ...context, awHomeMutationToken },
+                                        rebuildRuntime: {
+                                            ...context,
+                                            awHomeMutationToken,
+                                            ...(catalogOperation ? {
+                                                catalogOperationContext: catalogOperation,
+                                                expectedGenerationSetDigest: expectedEvidence.catalog.generationSetDigest,
+                                            } : {}),
+                                        },
                                         awHomeMutationToken,
+                                        applyTargets,
                                     });
                                 return result;
                             },