@lesliechan721/aw 0.1.0-beta.13 → 0.1.0-beta.15

package/dist/src/tui/controller.js

@@ -1,6 +1,8 @@
 import crypto from 'node:crypto';
+import { CatalogManagementError, } from './catalog-management.js';
 import { CatalogGenerationError } from '../utils/catalog-generation-error.js';
 import { readSafeOperationError } from '../utils/safe-operation-diagnostic.js';
+import { statusTargetActivation, statusTargetIntent, statusTargetOwnershipState, } from '../commands/status-v6.js';
 import { buildRebuildReceiptJson, requestedIntentAction } from '../output/command-receipt.js';
 import { buildOperationResultModel } from '../commands/operation-planner.js';
 import { buildOperationReviewProjection } from './operation-review-planner.js';
@@ -13,6 +15,7 @@ import { TuiRouter, } from './router.js';
 import { normalizeTuiRoute } from './screen-registry.js';
 import { CatalogSourcesSession } from './catalog-sources/session.js';
 import { catalogSourceAutoCheckOnlyValue, projectCatalogSourceMutationWarnings, } from './catalog-sources/review.js';
+import { buildPluginWriteTaskCandidates, pluginWriteTaskTargetKey, } from './plugin-write-task.js';
 export const PLUGIN_WRITE_BATCH_ACTIONS = [
     'install',
     'sync',
@@ -20,6 +23,57 @@ export const PLUGIN_WRITE_BATCH_ACTIONS = [
     'uninstall',
     'cleanup',
 ];
+export function pluginWriteBatchTargets(action, pluginIds, statusTargets) {
+    const selected = new Set(pluginIds);
+    const targets = [];
+    const add = (target, scope) => {
+        targets.push({ pluginId: target.pluginId, platform: target.platform, scope });
+    };
+    for (const target of statusTargets) {
+        if (!selected.has(target.pluginId))
+            continue;
+        const intent = statusTargetIntent(target);
+        const ownership = statusTargetOwnershipState(target);
+        const activation = statusTargetActivation(target);
+        const hasManagedOutput = ownership !== 'absent';
+        const hasCleanupEvidence = ownership === 'present' || ownership === 'partial'
+            || intent.relation === 'managed';
+        if (action === 'sync' || action === 'reinstall') {
+            intent.scopes.forEach((scope) => add(target, scope));
+            if (hasManagedOutput)
+                add(target, target.scope);
+            if (target.platform === 'codex') {
+                if (activation?.user === true)
+                    add(target, 'user');
+                if (activation?.project === true)
+                    add(target, 'project');
+            }
+        }
+        else if (action === 'uninstall') {
+            if (hasManagedOutput)
+                add(target, target.scope);
+            if (target.platform === 'codex') {
+                if (activation?.user === true)
+                    add(target, 'user');
+                if (activation?.project === true)
+                    add(target, 'project');
+            }
+        }
+        else if (hasCleanupEvidence) {
+            add(target, target.scope);
+            if (target.platform === 'codex') {
+                if (activation?.user === true)
+                    add(target, 'user');
+                if (activation?.project === true)
+                    add(target, 'project');
+            }
+        }
+    }
+    return [...new Map(targets.map((target) => [
+            [target.pluginId, target.platform, target.scope].join('\0'), target,
+        ])).values()].sort((left, right) => [left.pluginId, left.platform, left.scope].join('\0')
+        .localeCompare([right.pluginId, right.platform, right.scope].join('\0'), 'en'));
+}
 function reviewPreparationStageLabel(stage) {
     return {
         refresh: '刷新相关来源',
@@ -70,10 +124,25 @@ function canonicalBatchTargets(targets) {
     return [...byKey.values()].sort((left, right) => [left.pluginId, left.platform, left.scope].join('\0')
         .localeCompare([right.pluginId, right.platform, right.scope].join('\0'), 'en'));
 }
+function canonicalPluginWriteTaskTargets(targets) {
+    return [...new Map(targets.map((target) => [pluginWriteTaskTargetKey(target), target])).values()]
+        .sort((left, right) => pluginWriteTaskTargetKey(left)
+        .localeCompare(pluginWriteTaskTargetKey(right), 'en'));
+}
 function normalizeOperationIntent(intent) {
     if (intent.kind === 'configSave' && intent.retryApply && !intent.apply) {
         return { ...intent, apply: true };
     }
+    if (intent.kind === 'pluginWriteTask') {
+        return { ...intent, targets: canonicalPluginWriteTaskTargets(intent.targets) };
+    }
+    if (intent.kind === 'catalogManagement' && intent.action === 'storePrune') {
+        const items = [...new Map(intent.items.map((item) => [
+                `${item.category}\0${item.storeKey}`,
+                item,
+            ])).values()].sort((left, right) => `${left.category}\0${left.storeKey}`.localeCompare(`${right.category}\0${right.storeKey}`, 'en'));
+        return { ...intent, items };
+    }
     if (intent.kind !== 'pluginWriteBatch')
         return intent;
     if (intent.selection.kind === 'targets') {
@@ -92,6 +161,49 @@ function normalizeOperationIntent(intent) {
         },
     };
 }
+function assertPluginWriteTaskEvidence(intent, evidence) {
+    const candidate = evidence;
+    const plan = candidate.taskPlan;
+    if (!plan || plan.goal !== intent.goal || !Array.isArray(plan.requestedTargets)
+        || !Array.isArray(plan.executableTargets) || !Array.isArray(plan.blockedTargets)
+        || !Array.isArray(plan.causes) || !Array.isArray(plan.sources)
+        || typeof plan.targetFingerprint !== 'string' || typeof plan.planFingerprint !== 'string'
+        || JSON.stringify(plan.requestedTargets) !== JSON.stringify(intent.targets)
+        || plan.executableTargets.length === 0) {
+        throw new TuiOperationBlockedError('taskEvidenceInvalid', '任务确认信息不完整。');
+    }
+    if (plan.planFingerprint !== operationEvidenceFingerprint(evidence)) {
+        throw new TuiOperationBlockedError('taskEvidenceInvalid', '任务确认指纹无效。');
+    }
+    if (intent.executionPolicy === 'all' && plan.blockedTargets.length > 0) {
+        throw new TuiOperationBlockedError('taskHasBlockedTargets', '部分目标需要先处理，不能作为完整任务执行。');
+    }
+    const requested = new Set(plan.requestedTargets.map(pluginWriteTaskTargetKey));
+    const executable = new Set(plan.executableTargets.map(pluginWriteTaskTargetKey));
+    const blocked = new Set(plan.blockedTargets.map((target) => pluginWriteTaskTargetKey(target.target)));
+    if (executable.size !== plan.executableTargets.length || blocked.size !== plan.blockedTargets.length
+        || [...executable].some((key) => !requested.has(key) || blocked.has(key))
+        || [...blocked].some((key) => !requested.has(key))
+        || [...requested].some((key) => !executable.has(key) && !blocked.has(key))) {
+        throw new TuiOperationBlockedError('taskEvidenceInvalid', '任务目标分区无效。');
+    }
+    const grouped = new Set();
+    for (const source of plan.sources) {
+        if (!source.sourceId || !source.sourceIdentity || source.requestedTargets.length === 0
+            || source.executable !== Boolean(source.preview.operationPlan)
+            || source.requestedTargets.some((target) => !executable.has(pluginWriteTaskTargetKey(target))
+                || sourceIdFromPluginId(target.pluginId) !== source.sourceId)
+            || source.causes.some((cause) => cause.sourceId !== source.sourceId
+                || cause.sourceIdentity !== source.sourceIdentity
+                || cause.consumers.some((consumer) => !executable.has(pluginWriteTaskTargetKey(consumer))))) {
+            throw new TuiOperationBlockedError('taskEvidenceInvalid', '任务来源计划无效。');
+        }
+        source.requestedTargets.forEach((target) => grouped.add(pluginWriteTaskTargetKey(target)));
+    }
+    if ([...executable].some((key) => !grouped.has(key))) {
+        throw new TuiOperationBlockedError('taskEvidenceInvalid', '任务来源计划缺少可执行目标。');
+    }
+}
 function assertPluginWriteBatchEvidence(evidence) {
     const candidate = evidence;
     if (!Array.isArray(candidate.requestedPluginIds) || !Array.isArray(candidate.groups)) {
@@ -195,7 +307,62 @@ export function pluginWriteBatchFailedRequestedPluginIds(execution) {
     return canonicalPluginIds(pluginWriteBatchFailedRequestedTargets(execution)
         .map((target) => target.pluginId));
 }
+export function pluginWriteTaskFailedRequestedTargets(execution) {
+    const requested = new Map(execution.taskPlan.requestedTargets.map((target) => [
+        pluginWriteTaskTargetKey(target), target,
+    ]));
+    const failed = new Set();
+    const succeeded = new Set();
+    for (const source of execution.sourceResults) {
+        const sourceRequested = new Set(source.requestedTargets.map(pluginWriteTaskTargetKey));
+        if (source.result.targetResults.length === 0 && source.result.overallState !== 'succeeded') {
+            sourceRequested.forEach((key) => failed.add(key));
+            continue;
+        }
+        for (const result of source.result.targetResults) {
+            const pluginId = result.target.pluginId;
+            if (!pluginId)
+                continue;
+            const exactKey = pluginWriteTaskTargetKey({
+                pluginId,
+                platform: result.target.platform,
+                scope: result.target.scope,
+            });
+            if (sourceRequested.has(exactKey)) {
+                if (result.state === 'failed' || result.action === 'skipped')
+                    failed.add(exactKey);
+                else
+                    succeeded.add(exactKey);
+            }
+            if (result.state !== 'failed' && result.action !== 'skipped')
+                continue;
+            for (const cause of source.requestedTargets.length > 0
+                ? execution.taskPlan.causes.filter((cause) => cause.sourceId === source.sourceId) : []) {
+                if (pluginWriteTaskTargetKey(cause.repairTarget) !== exactKey)
+                    continue;
+                cause.consumers.forEach((consumer) => failed.add(pluginWriteTaskTargetKey(consumer)));
+            }
+            const placement = source.result.dependencyPlan?.targets.find((target) => target.pluginId === pluginId && target.platform === result.target.platform
+                && (target.requestedScope ?? target.resolvedScope) === result.target.scope);
+            for (const consumer of placement?.requiredByTargets ?? []) {
+                failed.add(pluginWriteTaskTargetKey(consumer));
+            }
+        }
+    }
+    for (const key of succeeded)
+        failed.delete(key);
+    return canonicalPluginWriteTaskTargets([...failed].flatMap((key) => {
+        const target = requested.get(key);
+        return target ? [target] : [];
+    }));
+}
 function collectOperationSensitiveValues(intent) {
+    if (intent.kind === 'catalogManagement') {
+        return [
+            ...('ownerUrl' in intent && intent.ownerUrl ? [intent.ownerUrl] : []),
+            ...('remoteUrl' in intent && intent.remoteUrl ? [intent.remoteUrl] : []),
+        ];
+    }
     if (intent.kind !== 'configSave')
         return [];
     const sensitiveKeys = new Set([...(intent.sensitiveKeys ?? []), ...(intent.privateKeys ?? [])]);
@@ -243,6 +410,53 @@ function cloneFrozen(value) {
     return deepFreeze(structuredClone(value));
 }
 export function operationEvidenceFingerprint(evidence) {
+    if (evidence.catalogManagement) {
+        const management = evidence.catalogManagement;
+        return crypto.createHash('sha256')
+            .update(JSON.stringify(stableValue(management.action === 'storePrune'
+            ? {
+                action: management.action,
+                workspaceBinding: management.workspaceBinding,
+                authorizedStoreItems: management.authorizedStoreItems,
+            }
+            : {
+                action: management.action,
+                workspaceBinding: management.workspaceBinding,
+                evidenceDigest: management.evidenceDigest,
+            })))
+            .digest('hex');
+    }
+    if ('taskPlan' in evidence) {
+        const task = evidence.taskPlan;
+        return crypto.createHash('sha256')
+            .update(JSON.stringify(stableValue({
+            catalog: evidence.catalog,
+            goal: task.goal,
+            requestedTargets: task.requestedTargets,
+            executableTargets: task.executableTargets,
+            causes: task.causes,
+            blockedTargets: task.blockedTargets,
+            targetFingerprint: task.targetFingerprint,
+            sources: task.sources.map((source) => ({
+                sourceId: source.sourceId,
+                sourceIdentity: source.sourceIdentity,
+                requestedTargets: source.requestedTargets,
+                causes: source.causes,
+                executable: source.executable,
+                planFingerprint: source.preview.operationPlan?.planFingerprint,
+                targetResults: source.preview.targetResults.map((target) => ({
+                    pluginId: target.target.pluginId,
+                    platform: target.target.platform,
+                    scope: target.target.scope,
+                    state: target.state,
+                    action: target.action,
+                    errorCode: target.errorCode,
+                    requiredBy: target.requiredBy,
+                })),
+            })),
+        })))
+            .digest('hex');
+    }
     if ('groups' in evidence && 'requestedPluginIds' in evidence) {
         const batch = evidence;
         return crypto.createHash('sha256')
@@ -337,6 +551,8 @@ function issueCode(error) {
         return safeDiagnosticCode(safeOperationError.code, 'operationBlocked');
     if (error instanceof TuiOperationBlockedError)
         return error.code;
+    if (error instanceof CatalogManagementError)
+        return error.code;
     if (error instanceof CatalogGenerationError)
         return error.code;
     if (error instanceof Error && error.name === 'CatalogSourcesConfigConflictError') {
@@ -408,6 +624,7 @@ export class TuiController {
     #retiring = false;
     #externalDrafts = [];
     #batchRetryIntent;
+    #taskRetryIntent;
     #operationHistory = new OperationHistoryStore();
     #sessionEpoch = 0;
     #lastRecordedResultId;
@@ -431,6 +648,7 @@ export class TuiController {
             onError: (error, code) => {
                 void this.#logErrorSafe(error, code);
             },
+            now: this.dependencies.now,
         });
         if (progressFeed) {
             this.#progressUnsubscribe = progressFeed.subscribe((progress) => {
@@ -622,6 +840,7 @@ export class TuiController {
         this.#installPlacementDraft = undefined;
         this.#recoverableInstallPlacementDraft = undefined;
         this.#batchRetryIntent = undefined;
+        this.#taskRetryIntent = undefined;
         this.#externalDrafts = [];
         this.#result = undefined;
         this.#resultAnchor = undefined;
@@ -774,6 +993,18 @@ export class TuiController {
     }
     #ensureOperationFlow(intent) {
         const active = this.#router.activeFlow();
+        if (intent.kind === 'catalogManagement') {
+            if (active?.kind === 'catalogManagement')
+                return;
+            this.#router.beginFlow('catalogManagement', this.#router.snapshot.current.route);
+            return;
+        }
+        if (intent.kind === 'pluginWriteTask') {
+            if (active?.kind === 'pluginWriteTask')
+                return;
+            this.#router.beginFlow('pluginWriteTask', this.#router.snapshot.current.route);
+            return;
+        }
         if (intent.kind === 'pluginWriteBatch') {
             if (active?.kind === 'batchWrite')
                 return;
@@ -818,7 +1049,9 @@ export class TuiController {
             : intent.kind === 'sourceMutation' && intent.action !== 'remove'
                 ? { name: 'sourceDetail', sourceId: intent.sourceId }
                 : intent.kind === 'catalogGeneration'
-                    ? { name: 'sourceDetail', sourceId: intent.sourceId }
+                    ? this.#router.snapshot.current.route.name === 'pluginWriteTask'
+                        ? this.#router.snapshot.current.route
+                        : { name: 'sourceDetail', sourceId: intent.sourceId }
                     : { name: 'sourceList' });
     }
     #stableResultRoute(intent, result) {
@@ -836,6 +1069,8 @@ export class TuiController {
         }
         if (intent.kind === 'pluginWriteBatch')
             return { name: 'pluginList', mode: 'installed' };
+        if (intent.kind === 'pluginWriteTask')
+            return { name: 'pluginList', mode: 'installed' };
         if (intent.kind === 'portableInstall' || intent.kind === 'configSave' || intent.kind === 'configReset') {
             return this.#normalizeRoute({ name: 'pluginDetail', pluginId: intent.pluginId });
         }
@@ -843,8 +1078,22 @@ export class TuiController {
             return this.#normalizeRoute({ name: 'sourceDetail', sourceId: intent.sourceId });
         }
         if (intent.kind === 'catalogGeneration') {
+            if ('returnRoute' in result && result.returnRoute?.name === 'pluginWriteTask') {
+                return this.#normalizeRoute(result.returnRoute);
+            }
             return this.#normalizeRoute({ name: 'sourceDetail', sourceId: intent.sourceId });
         }
+        if (intent.kind === 'catalogManagement') {
+            if (intent.action === 'devActivate' || intent.action === 'devDeactivate') {
+                return { name: 'catalogDev', step: 'overview' };
+            }
+            if (intent.action === 'storePrune')
+                return { name: 'catalogStore' };
+            if (intent.action === 'publishPlan' || intent.action === 'publishApply') {
+                return { name: 'catalogPublish', step: 'overview' };
+            }
+            return { name: 'catalogWorkspace', view: 'overview' };
+        }
         return { name: 'sourceList' };
     }
     #showResult(result, intent) {
@@ -883,6 +1132,19 @@ export class TuiController {
                 },
             }
             : undefined;
+        this.#taskRetryIntent = intent.kind === 'pluginWriteTask'
+            && 'summary' in result
+            && result.summary?.task
+            && (result.summary.task.retryTargets?.length ?? 0) > 0
+            ? {
+                ...structuredClone(intent),
+                targets: result.summary.task.retryTargets.map((target) => {
+                    const current = this.listPluginWriteTaskCandidates(intent.goal).find((candidate) => pluginWriteTaskTargetKey(candidate.target) === pluginWriteTaskTargetKey(target));
+                    return structuredClone(current?.eligible ? current.target : target);
+                }),
+                executionPolicy: 'all',
+            }
+            : undefined;
         if (!this.#router.finishFlow(target, terminal))
             this.#router.replace(terminal);
     }
@@ -923,14 +1185,18 @@ export class TuiController {
         this.#catalogSourcesSession.configure(status.payload.catalog.sources.map((source) => {
             const generation = this.#catalogGenerations.get(source.id);
             const detail = details.get(source.id);
+            const probeFingerprint = JSON.stringify({
+                sourceIdentity: source.identity,
+                requestedRef: source.requestedRef,
+            });
             return {
                 sourceId: source.id,
                 primary: source.primary,
                 autoCheck: this.dependencies.probeCatalogFreshness !== undefined
                     && (detail?.autoCheck ?? true),
+                probeFingerprint,
                 fingerprint: JSON.stringify({
-                    sourceIdentity: source.identity,
-                    requestedRef: source.requestedRef,
+                    probeFingerprint,
                     activeStoreKey: generation?.active?.storeKey,
                     generationState: generation?.state,
                     generationErrorCode: generation?.errorCode,
@@ -1252,8 +1518,11 @@ export class TuiController {
             return origin;
         if (this.#router.snapshot.current.route.name === 'result'
             && this.#resultAnchor
-            && (this.#resultAnchor.name === 'pluginPreview' || this.#resultAnchor.name === 'pluginDetail')
-            && this.#resultAnchor.pluginId === pluginId) {
+            && (this.#resultAnchor.name === 'pluginPreview' || this.#resultAnchor.name === 'pluginDetail'
+                || this.#resultAnchor.name === 'pluginWriteTask')
+            && (this.#resultAnchor.pluginId === pluginId
+                || this.#resultAnchor.name === 'pluginWriteTask'
+                    && this.#resultAnchor.targetKeys?.some((key) => key.startsWith(`${pluginId}\0`)))) {
             return structuredClone(this.#resultAnchor);
         }
         return undefined;
@@ -1621,16 +1890,30 @@ export class TuiController {
         return cloneFrozen((this.#viewModel?.plugins ?? []).filter((plugin) => (!options.sourceId || plugin.sourceId === options.sourceId)
             && (options.mode === 'browse' || hasInstalledPlacement(plugin) || plugin.savedConfigScopes.length > 0)
             && (options.installFilter !== 'uninstalled' || !hasInstalledPlacement(plugin))
+            && (options.installFilter !== 'updateAvailable' || plugin.update?.state === 'available')
             && (!query || `${plugin.displayName}\n${plugin.description}\n${plugin.sourceId}`.toLocaleLowerCase('en').includes(query))));
     }
     getPluginOverview(pluginId) {
         const plugin = this.#viewModel?.plugins.find((entry) => entry.pluginId === pluginId);
         return plugin ? cloneFrozen(plugin) : undefined;
     }
+    listCurrentProjectIntentRoots() {
+        return cloneFrozen([...new Set((this.#status?.payload.targets ?? []).flatMap((target) => {
+                const intent = statusTargetIntent(target);
+                return intent.relation === 'root' && intent.scopes.includes('project')
+                    ? [target.pluginId] : [];
+            }))].sort((left, right) => left.localeCompare(right, 'en')));
+    }
+    listPluginWriteBatchTargets(action, pluginIds) {
+        return cloneFrozen(pluginWriteBatchTargets(action, pluginIds, this.#status?.payload.targets ?? []));
+    }
     getPluginDependencyOverview(pluginId) {
         const overview = this.#viewModel?.dependencyOverviews.find((entry) => entry.pluginId === pluginId);
         return overview ? cloneFrozen(overview) : undefined;
     }
+    listPluginDependencyOverviews() {
+        return cloneFrozen(this.#viewModel?.dependencyOverviews ?? []);
+    }
     getBlockingDependents(pluginId, platform, scope) {
         const dependents = this.#viewModel?.dependencyOverviews.find((entry) => entry.pluginId === pluginId)?.dependents ?? [];
         return cloneFrozen(dependents.flatMap((dependent) => {
@@ -1756,7 +2039,7 @@ export class TuiController {
         return this.#catalogSourcesSession.fullValidate(sourceId);
     }
     setExternalDraftState(states = []) {
-        const priority = { sourceDraft: 0, batchDraft: 1, configDraft: 2 };
+        const priority = { sourceDraft: 0, batchDraft: 1, catalogDraft: 2, configDraft: 3 };
         this.#externalDrafts = structuredClone(states).sort((left, right) => priority[left.kind] - priority[right.kind] || left.owner.localeCompare(right.owner, 'en'));
         this.#publish();
     }
@@ -1769,6 +2052,26 @@ export class TuiController {
     startPluginWriteBatchReview(intent) {
         return this.startReviewPreparation(intent, { name: 'batchPlacement' });
     }
+    startPluginWriteTaskReview(intent, returnRoute) {
+        return this.startReviewPreparation(intent, returnRoute);
+    }
+    beginNestedPluginWriteTask(route) {
+        this.#assertAcceptingActions();
+        const current = this.#router.snapshot.current.route;
+        if (current.name !== 'pluginWriteTask') {
+            throw new TuiOperationBlockedError('taskOriginUnavailable', '嵌套任务缺少父任务。');
+        }
+        this.#router.beginFlow('pluginWriteTask', current);
+        this.#router.push(route);
+        this.#publish();
+    }
+    pluginWriteTaskReturnRoute(route) {
+        const active = this.#router.activeFlow();
+        return structuredClone(active?.kind === 'pluginWriteTask'
+            && active.returnTarget.name === 'pluginWriteTask'
+            ? active.returnTarget
+            : route);
+    }
     retryFailedPluginWriteBatch() {
         if (!this.#batchRetryIntent)
             return undefined;
@@ -1776,6 +2079,13 @@ export class TuiController {
         this.#batchRetryIntent = undefined;
         return this.startReviewPreparation(intent, { name: 'pluginList', mode: 'installed' });
     }
+    retryFailedPluginWriteTask() {
+        if (!this.#taskRetryIntent)
+            return undefined;
+        const intent = structuredClone(this.#taskRetryIntent);
+        this.#taskRetryIntent = undefined;
+        return this.startReviewPreparation(intent, { name: 'pluginList', mode: 'installed' });
+    }
     catalogActivationBlockReason() {
         if (this.#externalDrafts[0])
             return this.#externalDrafts[0].kind;
@@ -1790,11 +2100,26 @@ export class TuiController {
             return 'writeProgress';
         return undefined;
     }
-    catalogSourceRecoveryBlockReason() {
+    catalogSourceRecoveryBlockReason(intent) {
         const activeFlow = this.#router.activeFlow();
+        const route = this.#router.snapshot.current.route;
+        const ownedFrozenBatchTask = intent !== undefined
+            && route.name === 'pluginWriteTask'
+            && route.targetKeys !== undefined
+            && route.targetKeys.length > 0
+            && route.batchOrigin !== undefined
+            && (activeFlow?.id === route.batchOrigin.flowId
+                || activeFlow?.parentFlowId === route.batchOrigin.flowId)
+            && this.listPluginWriteTaskCandidates(route.goal).some((candidate) => candidate.sourceId === intent.sourceId
+                && candidate.blockReason === 'catalogActivationRequired'
+                && route.targetKeys.includes(pluginWriteTaskTargetKey(candidate.target)));
         const blockingExternalDraft = this.#externalDrafts.find((draft) => !(draft.kind === 'configDraft'
             && activeFlow?.kind === 'sourceRecovery'
-            && activeFlow.parentFlowId !== undefined));
+            && activeFlow.parentFlowId !== undefined)
+            && !(ownedFrozenBatchTask
+                && draft.kind === 'batchDraft'
+                && draft.owner === route.batchOrigin?.owner
+                && draft.flowId === route.batchOrigin.flowId));
         if (blockingExternalDraft)
             return blockingExternalDraft.kind;
         if (this.#portableDraft)
@@ -1865,6 +2190,61 @@ export class TuiController {
             : this.#abort.signal;
         return cloneFrozen(await this.#trackRead(this.dependencies.getConfigPage(pluginId, structuredClone(layer), combined)));
     }
+    async selectCatalogWorkspace(workspaceRoot) {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.selectWorkspace(workspaceRoot)));
+    }
+    async getCatalogWorkspaceManagement() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.getWorkspace()));
+    }
+    async validateCatalogWorkspace() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.validateWorkspace()));
+    }
+    async getCatalogDevManagement() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.getDev()));
+    }
+    async getCatalogStoreManagement() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.getStore()));
+    }
+    async getCatalogPublicationManagement() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.catalogManagement) {
+            throw new TuiOperationBlockedError('catalogManagementUnavailable', 'Catalog management is unavailable.');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.catalogManagement.getPublication()));
+    }
+    async previewConfigSaveImpact(intent, signal) {
+        this.#assertAcceptingActions();
+        const normalized = normalizeOperationIntent(intent);
+        this.#validateReviewIntent(normalized);
+        const combined = signal
+            ? AbortSignal.any([this.#abort.signal, signal])
+            : this.#abort.signal;
+        const evidence = await this.#trackRead(this.#prepareReviewEvidence(normalized, combined));
+        if (!evidence.config) {
+            throw new TuiOperationBlockedError('configImpactUnavailable', '无法确定设置修改的应用影响。');
+        }
+        return cloneFrozen(evidence.config);
+    }
     async getConfigResetAvailability(pluginId, layer) {
         this.#assertAcceptingActions();
         if (!this.dependencies.getConfigResetAvailability) {
@@ -1875,6 +2255,11 @@ export class TuiController {
     listUserIssues() {
         return cloneFrozen(this.#viewModel?.issues ?? []);
     }
+    listPluginWriteTaskCandidates(goal) {
+        return cloneFrozen(this.#viewModel
+            ? buildPluginWriteTaskCandidates(this.#viewModel, goal)
+            : []);
+    }
     async buildOperationReview(intent, returnRoute) {
         this.#assertAcceptingActions();
         intent = normalizeOperationIntent(intent);
@@ -1895,7 +2280,7 @@ export class TuiController {
         this.#assertAcceptingActions();
         intent = normalizeOperationIntent(intent);
         if (intent.kind === 'catalogGeneration' && !intent.sourceMutation) {
-            const blockReason = this.catalogSourceRecoveryBlockReason();
+            const blockReason = this.catalogSourceRecoveryBlockReason(intent);
             if (blockReason) {
                 throw new TuiOperationBlockedError('catalogActivationBlocked', `Catalog Active 切换已阻止：${blockReason}。请先完成或放弃当前草稿或操作。`);
             }
@@ -1958,6 +2343,37 @@ export class TuiController {
         return this.startReviewPreparation(structuredClone(intent), preparation.returnRoute);
     }
     #validateReviewIntent(intent) {
+        if (intent.kind === 'catalogManagement') {
+            if (intent.action === 'storePrune' && intent.items.length === 0) {
+                throw new TuiOperationBlockedError('catalogStoreSelectionInvalid', 'Select at least one reclaimable Catalog store item.');
+            }
+            if (intent.action === 'workspaceVersion'
+                && (intent.version === undefined) === (intent.bump === undefined)) {
+                throw new TuiOperationBlockedError('catalogVersionSelectionInvalid', 'Select exactly one Catalog version or bump level.');
+            }
+            if ((intent.action === 'publishPlan' || intent.action === 'publishApply')
+                && intent.remote !== undefined && intent.remoteUrl !== undefined) {
+                throw new TuiOperationBlockedError('catalogPublicationTargetInvalid', 'Select a Git remote name or one direct remote URL.');
+            }
+            if (intent.action === 'publishApply'
+                && !/^sha256:[0-9a-f]{64}$/u.test(intent.expectedPlanDigest)) {
+                throw new TuiOperationBlockedError('catalogPublicationPlanInvalid', 'Select an exact prepared Catalog publication plan.');
+            }
+        }
+        if (intent.kind === 'pluginWriteTask') {
+            if (intent.targets.length === 0
+                || JSON.stringify(intent.targets) !== JSON.stringify(canonicalPluginWriteTaskTargets(intent.targets))) {
+                throw new TuiOperationBlockedError('taskSelectionInvalid', '任务目标必须是非空精确目标集合。');
+            }
+            for (const target of intent.targets) {
+                sourceIdFromPluginId(target.pluginId);
+                if ((target.platform !== 'codex' && target.platform !== 'claude')
+                    || (target.scope !== 'user' && target.scope !== 'project')
+                    || (intent.goal === 'update') !== Boolean(target.expectedUpdate)) {
+                    throw new TuiOperationBlockedError('taskSelectionInvalid', '任务目标或版本证据无效。');
+                }
+            }
+        }
         if (intent.kind === 'pluginWriteBatch') {
             if (intent.selection.kind === 'currentProjectIntentRoots'
                 && (intent.action !== 'sync' || intent.scope !== 'project')) {
@@ -1978,8 +2394,12 @@ export class TuiController {
         }
     }
     #reviewPreparationLabel(intent) {
+        if (intent.kind === 'catalogManagement')
+            return 'Catalog 管理';
         if (intent.kind === 'catalogSourcesRecovery')
             return 'Catalog 来源配置';
+        if (intent.kind === 'pluginWriteTask')
+            return `${intent.targets.length} 个安装位置`;
         if (intent.kind === 'pluginWriteBatch') {
             return intent.selection.kind === 'selected'
                 ? `${intent.selection.pluginIds.length} 个插件`
@@ -2033,9 +2453,10 @@ export class TuiController {
             preparation.snapshot.stages = preparation.snapshot.stages.map((stage) => stage.state === 'running' ? { ...stage, state: 'completed' } : stage);
             this.#publish();
             const returnRoute = structuredClone(preparation.returnRoute);
+            this.#storeOperationReview(intent, evidence, 'replace', returnRoute);
             this.#reviewPreparationIntents.delete(preparation.snapshot.id);
             this.#reviewPreparation = undefined;
-            this.#storeOperationReview(intent, evidence, 'replace', returnRoute);
+            this.#publish();
         }
         catch (error) {
             if (!this.#reviewPreparationIsCurrent(token))
@@ -2148,6 +2569,8 @@ export class TuiController {
         this.#ensureOperationFlow(intent);
         if (intent.kind === 'pluginWriteBatch')
             assertPluginWriteBatchEvidence(evidence);
+        if (intent.kind === 'pluginWriteTask')
+            assertPluginWriteTaskEvidence(intent, evidence);
         if (this.#router.snapshot.current.route.name === 'result')
             navigation = 'replace';
         const projection = buildOperationReviewProjection({
@@ -2164,10 +2587,12 @@ export class TuiController {
         const expiresAt = now
             + (this.dependencies.reviewTtlMs ?? 2 * 60_000);
         const pluginId = 'pluginId' in intent ? intent.pluginId
-            : 'sourceId' in intent ? intent.sourceId
+            : 'sourceId' in intent ? intent.sourceId ?? 'Catalog 管理'
                 : intent.kind === 'pluginWriteBatch'
                     ? `${evidence.requestedPluginIds.length} 个插件`
-                    : 'Catalog 来源配置';
+                    : intent.kind === 'pluginWriteTask'
+                        ? `${evidence.taskPlan.requestedTargets.length} 个安装位置`
+                        : 'Catalog 来源配置';
         if ('pluginId' in intent)
             sourceIdFromPluginId(intent.pluginId);
         const pluginVersion = 'pluginId' in intent
@@ -2184,6 +2609,7 @@ export class TuiController {
                     ? { sourceAction: intent.sourceMutation.action } : {}),
             ...(intent.kind === 'pluginWrite' ? { pluginAction: intent.action } : {}),
             ...(intent.kind === 'pluginWriteBatch' ? { pluginAction: intent.action } : {}),
+            ...(intent.kind === 'pluginWriteTask' ? { taskGoal: intent.goal } : {}),
             ...(intent.kind === 'pluginWrite' && intent.originIssue
                 ? { originIssue: intent.originIssue }
                 : {}),
@@ -2204,6 +2630,15 @@ export class TuiController {
                         .filter((group) => group.executable).length,
                 },
             } : {}),
+            ...(intent.kind === 'pluginWriteTask' ? {
+                task: {
+                    goal: intent.goal,
+                    requestedTargetCount: evidence.taskPlan.requestedTargets.length,
+                    executableTargetCount: evidence.taskPlan.executableTargets.length,
+                    blockedTargetCount: evidence.taskPlan.blockedTargets.length,
+                    causeCount: evidence.taskPlan.causes.length,
+                },
+            } : {}),
             ...(evidence.source && 'catalogVersion' in evidence.source
                 && typeof evidence.source.catalogVersion === 'string'
                 && evidence.source.snapshotDigest
@@ -2267,7 +2702,9 @@ export class TuiController {
         this.#progressFeed?.clearCurrent?.();
         const dependencyTargets = ticket.intent.kind === 'pluginWriteBatch'
             ? ticket.evidence.groups.flatMap((group) => group.preview.dependencyPlan?.targets ?? [])
-            : ticket.evidence.dependencyPlan?.targets ?? [];
+            : ticket.intent.kind === 'pluginWriteTask'
+                ? ticket.evidence.taskPlan.sources.flatMap((source) => source.preview.dependencyPlan?.targets ?? [])
+                : ticket.evidence.dependencyPlan?.targets ?? [];
         this.#progressTargets = dependencyTargets.map((target) => ({
             pluginId: target.pluginId,
             platform: target.platform,
@@ -2285,15 +2722,18 @@ export class TuiController {
             current: {
                 target: ticket.intent.kind === 'pluginWriteBatch'
                     ? `${ticket.evidence.requestedPluginIds.length} 个插件`
-                    : 'pluginId' in ticket.intent ? ticket.intent.pluginId
-                        : 'sourceId' in ticket.intent ? ticket.intent.sourceId : 'Catalog 来源配置',
+                    : ticket.intent.kind === 'pluginWriteTask'
+                        ? `${ticket.evidence.taskPlan.executableTargets.length} 个安装位置`
+                        : 'pluginId' in ticket.intent ? ticket.intent.pluginId
+                            : 'sourceId' in ticket.intent ? ticket.intent.sourceId ?? 'Catalog 管理' : 'Catalog 来源配置',
                 phase: '验证当前状态',
             },
         };
         this.#router.replace({ name: 'progress', operationId });
         this.#publish();
         try {
-            if (ticket.intent.kind !== 'pluginWrite' && ticket.intent.kind !== 'pluginWriteBatch') {
+            if (ticket.intent.kind !== 'pluginWrite' && ticket.intent.kind !== 'pluginWriteBatch'
+                && ticket.intent.kind !== 'pluginWriteTask') {
                 await this.dependencies.validateIntent?.(structuredClone(ticket.intent), this.#abort.signal);
             }
         }
@@ -2325,6 +2765,7 @@ export class TuiController {
         if (!this.#operationIsCurrent(generation))
             return this.#detachedBlocked(operationId, ticket.intent);
         if (ticket.intent.kind !== 'pluginWrite' && ticket.intent.kind !== 'pluginWriteBatch'
+            && ticket.intent.kind !== 'pluginWriteTask'
             && ticket.intent.kind !== 'catalogGeneration') {
             let current;
             try {
@@ -2358,6 +2799,63 @@ export class TuiController {
                 ...executionProjection,
                 sensitiveValues: collectOperationSensitiveValues(ticket.intent),
             });
+            if (ticket.intent.kind === 'catalogManagement') {
+                if (ticket.intent.action === 'devActivate' || ticket.intent.action === 'devDeactivate') {
+                    this.dependencies.beginCatalogSession?.();
+                    generation = ++this.#generation;
+                    try {
+                        const refreshed = await this.dependencies.loadStatus(this.#abort.signal);
+                        if (!this.#operationIsCurrent(generation)) {
+                            return this.#detachedBlocked(operationId, ticket.intent);
+                        }
+                        this.#applyStatus(refreshed);
+                    }
+                    catch (reloadError) {
+                        if (!this.#operationIsCurrent(generation)) {
+                            return this.#detachedBlocked(operationId, ticket.intent);
+                        }
+                        await this.#logErrorSafe(reloadError, 'tuiStateReloadFailed', {
+                            privateConfigOperation: true,
+                        });
+                        this.#status = undefined;
+                        this.#viewModel = undefined;
+                        this.#phase = 'error';
+                        this.#loadError = {
+                            code: 'tuiStateReloadFailed',
+                            message: 'Catalog 来源已变更，但插件状态刷新失败。请重新加载后再继续操作。',
+                        };
+                        return this.#setBlocked(operationId, 'tuiStateReloadFailed', {
+                            intent: ticket.intent,
+                            navigation: 'result',
+                            returnRoute: ticket.returnRoute,
+                            writeMayHaveCompleted: true,
+                        });
+                    }
+                }
+                const baseSummary = operationResultSummary(ticket.intent, execution);
+                const summary = {
+                    ...baseSummary,
+                    elapsedMs: Math.max(0, (this.dependencies.now?.() ?? Date.now()) - startedAtMs),
+                    messages: [...this.#progress.messages, ...(baseSummary.messages ?? [])].slice(-8)
+                        .map((message) => sanitizeDiagnosticText(message, [], collectOperationSensitiveValues(ticket.intent))),
+                };
+                const projection = this.#operationDiagnostics.get(operationId);
+                if (projection)
+                    projection.effects.finalVerification = 'completed';
+                this.#progress = { ...this.#progress, elapsedMs: summary.elapsedMs };
+                const result = {
+                    state: summary.code === 'operationPartial' ? 'partial' : 'succeeded',
+                    operationId,
+                    summary,
+                    operationKind: ticket.intent.kind,
+                    returnRoute: structuredClone(this.#normalizeRoute(ticket.returnRoute)),
+                };
+                this.#result = result;
+                this.#activeReview = undefined;
+                this.#showResult(result, ticket.intent);
+                this.#publish();
+                return cloneFrozen(result);
+            }
             if (ticket.intent.kind === 'sourceMutation' && ticket.intent.action === 'update') {
                 const confirmedAutoCheck = catalogSourceAutoCheckOnlyValue(ticket.intent.update);
                 if (confirmedAutoCheck !== undefined) {
@@ -2453,6 +2951,17 @@ export class TuiController {
             if (!this.#operationIsCurrent(generation))
                 return this.#detachedBlocked(operationId, ticket.intent);
             this.#applyStatus(refreshed);
+            if (ticket.intent.kind === 'catalogGeneration') {
+                const completed = typeof execution === 'object' && execution !== null
+                    ? execution.generation
+                    : undefined;
+                const active = this.#catalogGenerations.get(ticket.intent.sourceId)?.active;
+                if (completed && active
+                    && active.catalogVersion === completed.resolution.catalogVersion
+                    && active.resolvedCommit === completed.resolution.resolvedCommit) {
+                    this.#catalogSourcesSession.recordVerifiedGeneration(ticket.intent.sourceId, active);
+                }
+            }
             const verifiedProjection = this.#operationDiagnostics.get(operationId);
             if (verifiedProjection && verifiedProjection.effects.finalVerification !== 'failed') {
                 verifiedProjection.effects.finalVerification = 'completed';
@@ -2463,6 +2972,7 @@ export class TuiController {
             }
             const pluginSummary = ticket.intent.kind === 'pluginWrite'
                 || ticket.intent.kind === 'pluginWriteBatch'
+                || ticket.intent.kind === 'pluginWriteTask'
                 ? operationResultSummary(ticket.intent, execution)
                 : undefined;
             const hasFailedDependencyTarget = pluginSummary?.targets?.some((target) => target.relation !== undefined && target.relation !== 'requested'
@@ -2503,9 +3013,10 @@ export class TuiController {
                     intent: ticket.intent,
                     navigation: 'result',
                     returnRoute: ticket.returnRoute,
-                    ...(ticket.intent.kind === 'pluginWriteBatch' || dependencyFailure || dependencyStillRequired
+                    ...(ticket.intent.kind === 'pluginWriteBatch' || ticket.intent.kind === 'pluginWriteTask'
+                        || dependencyFailure || dependencyStillRequired
                         ? { summary: pluginSummary } : {}),
-                    ...(ticket.intent.kind !== 'pluginWriteBatch'
+                    ...(ticket.intent.kind !== 'pluginWriteBatch' && ticket.intent.kind !== 'pluginWriteTask'
                         && !dependencyFailure && !dependencyStillRequired && ['started', 'partial', 'completed', 'failed', 'unknown'].includes(this.#operationDiagnostics.get(operationId)?.effects.awWrite ?? 'unknown') ? { writeMayHaveCompleted: true } : {}),
                 });
             }
@@ -2579,7 +3090,9 @@ export class TuiController {
                     : ticket.intent.kind === 'sourceMutation' && ticket.intent.action === 'update'
                         ? { name: 'sourceDetail', sourceId: ticket.intent.sourceId }
                         : ticket.intent.kind === 'catalogGeneration'
-                            ? { name: 'sourceDetail', sourceId: ticket.intent.sourceId }
+                            ? ticket.returnRoute.name === 'pluginWriteTask'
+                                ? ticket.returnRoute
+                                : { name: 'sourceDetail', sourceId: ticket.intent.sourceId }
                             : ticket.returnRoute)),
             };
             if ((ticket.intent.kind === 'configSave' || ticket.intent.kind === 'configReset')
@@ -2620,6 +3133,14 @@ export class TuiController {
                 this.#operationDiagnostics.delete(operationId);
                 return this.#rebuildStaleReview(ticket, operationId, undefined, generation);
             }
+            if (ticket.intent.kind === 'catalogManagement') {
+                return this.#setBlocked(operationId, code, {
+                    intent: ticket.intent,
+                    navigation: 'result',
+                    returnRoute: ticket.returnRoute,
+                    writeMayHaveCompleted: true,
+                });
+            }
             generation = ++this.#generation;
             let finalVerification = 'completed';
             try {
@@ -2723,6 +3244,30 @@ export class TuiController {
         });
     }
     async #rebuildStaleReview(ticket, operationId, currentEvidence, generation = this.#generation) {
+        if (ticket.intent.kind === 'catalogManagement') {
+            let evidence = currentEvidence;
+            try {
+                evidence ??= await this.dependencies.captureEvidence(structuredClone(ticket.intent), this.#abort.signal);
+            }
+            catch (error) {
+                const code = issueCode(error);
+                await this.#logOperationError(error, code, ticket.intent);
+                return this.#setBlocked(operationId, code, {
+                    intent: ticket.intent,
+                    returnRoute: ticket.returnRoute,
+                });
+            }
+            const review = this.#storeOperationReview(ticket.intent, evidence, 'replace', ticket.returnRoute);
+            const result = {
+                state: 'stale',
+                operationId,
+                review,
+                ...this.#operationIdentity(ticket.intent),
+            };
+            this.#result = result;
+            this.#publish();
+            return cloneFrozen(result);
+        }
         this.dependencies.beginCatalogSession?.();
         generation = ++this.#generation;
         try {
@@ -2874,6 +3419,22 @@ export class TuiController {
     }
 }
 function operationResultSummaryUnsafe(intent, execution) {
+    if (intent.kind === 'catalogManagement') {
+        const result = execution;
+        return {
+            code: result.state === 'partial' ? 'operationPartial' : 'operationSucceeded',
+            message: result.message,
+            messages: result.messages,
+            catalogManagement: {
+                action: result.action,
+                state: result.state,
+                ...(result.catalogVersion ? { catalogVersion: result.catalogVersion } : {}),
+                ...(result.planDigest ? { planDigest: result.planDigest } : {}),
+                ...(result.store ? { store: structuredClone(result.store) } : {}),
+                ...(result.publication ? { publication: structuredClone(result.publication) } : {}),
+            },
+        };
+    }
     if (intent.kind === 'catalogSourcesRecovery') {
         const result = execution;
         return {
@@ -2950,6 +3511,131 @@ function operationResultSummaryUnsafe(intent, execution) {
             },
         };
     }
+    if (intent.kind === 'pluginWriteTask') {
+        const taskExecution = execution;
+        const failedTargets = pluginWriteTaskFailedRequestedTargets(taskExecution);
+        const failedKeys = new Set(failedTargets.map(pluginWriteTaskTargetKey));
+        const technicalTargets = taskExecution.targetResults.map((entry) => {
+            const placement = taskExecution.dependencyPlan?.targets.find((target) => target.pluginId === entry.target.pluginId && target.platform === entry.target.platform
+                && (target.requestedScope ?? target.resolvedScope) === entry.target.scope);
+            return {
+                pluginId: entry.target.pluginId,
+                platform: entry.target.platform,
+                scope: entry.target.scope,
+                state: entry.action === 'skipped' ? 'skipped'
+                    : entry.state === 'failed' ? 'failed'
+                        : entry.action === 'keep' ? 'kept' : 'completed',
+                relation: entry.relation === 'requested' ? 'requested'
+                    : placement?.depth === 1 ? 'direct' : 'transitive',
+                requiredBy: entry.requiredBy,
+                ...(entry.errorCode ? { errorCode: safeDiagnosticCode(entry.errorCode, 'writeFailed') } : {}),
+            };
+        });
+        const blocked = new Map(taskExecution.taskPlan.blockedTargets.map((entry) => [
+            pluginWriteTaskTargetKey(entry.target), entry,
+        ]));
+        const relatedResults = (target) => {
+            const key = pluginWriteTaskTargetKey(target);
+            const source = taskExecution.sourceResults.find((candidate) => candidate.requestedTargets.some((requested) => pluginWriteTaskTargetKey(requested) === key));
+            const related = source?.result.targetResults.filter((entry) => {
+                const pluginId = entry.target.pluginId;
+                if (!pluginId)
+                    return false;
+                const executionKey = pluginWriteTaskTargetKey({
+                    pluginId,
+                    platform: entry.target.platform,
+                    scope: entry.target.scope,
+                });
+                if (executionKey === key)
+                    return true;
+                if (taskExecution.taskPlan.causes.some((cause) => pluginWriteTaskTargetKey(cause.repairTarget) === executionKey
+                    && cause.consumers.some((consumer) => pluginWriteTaskTargetKey(consumer) === key)))
+                    return true;
+                const placement = source.result.dependencyPlan?.targets.find((candidate) => candidate.pluginId === pluginId && candidate.platform === entry.target.platform
+                    && (candidate.requestedScope ?? candidate.resolvedScope) === entry.target.scope);
+                return placement?.requiredByTargets?.some((consumer) => pluginWriteTaskTargetKey(consumer) === key) ?? false;
+            }) ?? [];
+            const targetResults = related.map((entry) => {
+                const placement = source?.result.dependencyPlan?.targets.find((candidate) => candidate.pluginId === entry.target.pluginId
+                    && candidate.platform === entry.target.platform
+                    && (candidate.requestedScope ?? candidate.resolvedScope) === entry.target.scope);
+                return {
+                    pluginId: entry.target.pluginId,
+                    platform: entry.target.platform,
+                    scope: entry.target.scope,
+                    state: entry.action === 'skipped' ? 'skipped'
+                        : entry.state === 'failed' ? 'failed'
+                            : entry.action === 'keep' ? 'kept' : 'completed',
+                    relation: entry.relation === 'requested' ? 'requested'
+                        : placement?.depth === 1 ? 'direct' : 'transitive',
+                    ...(entry.errorCode ? { errorCode: safeDiagnosticCode(entry.errorCode, 'writeFailed') } : {}),
+                };
+            });
+            if (blocked.has(key) && !targetResults.some((entry) => entry.pluginId === target.pluginId && entry.platform === target.platform
+                && entry.scope === target.scope)) {
+                targetResults.unshift({
+                    pluginId: target.pluginId,
+                    platform: target.platform,
+                    scope: target.scope,
+                    state: 'skipped',
+                    relation: 'requested',
+                });
+            }
+            const hasFailed = targetResults.some((entry) => entry.state === 'failed' || entry.state === 'skipped');
+            const hasCompleted = targetResults.some((entry) => entry.state === 'completed' || entry.state === 'kept');
+            const state = blocked.has(key) ? 'blocked'
+                : !source ? 'notStarted'
+                    : hasFailed && hasCompleted ? 'partial'
+                        : hasFailed || failedKeys.has(key) ? 'failed'
+                            : targetResults.length > 0 && targetResults.every((entry) => entry.state === 'kept')
+                                ? 'kept' : targetResults.length > 0 ? 'completed' : 'notStarted';
+            return { state, targets: targetResults };
+        };
+        const roots = [...new Set(taskExecution.taskPlan.requestedTargets
+                .map((target) => target.pluginId))].map((pluginId) => {
+            const requestedTargets = taskExecution.taskPlan.requestedTargets.filter((target) => target.pluginId === pluginId);
+            const positions = requestedTargets.map((target) => relatedResults(target));
+            const successfulPositions = positions.filter((position) => position.state === 'completed' || position.state === 'kept');
+            const state = successfulPositions.length > 0
+                ? successfulPositions.length === positions.length
+                    ? positions.every((position) => position.state === 'kept') ? 'kept' : 'completed'
+                    : 'partial'
+                : positions.some((position) => position.state === 'failed' || position.state === 'partial')
+                    ? 'failed'
+                    : positions.some((position) => position.state === 'notStarted') ? 'notStarted' : 'blocked';
+            const targets = [...new Map(positions.flatMap((position) => position.targets).map((target) => [[
+                        target.pluginId ?? '', target.platform, target.scope,
+                    ].join('\0'), target])).values()];
+            const causeKeys = [...new Set(taskExecution.taskPlan.causes.filter((cause) => cause.consumers.some((consumer) => consumer.pluginId === pluginId))
+                    .map((cause) => cause.causeKey))];
+            return { pluginId, state, causeKeys, targets };
+        });
+        const retryTargets = canonicalPluginWriteTaskTargets(roots.flatMap((root) => root.state === 'failed' || root.state === 'partial' || root.state === 'notStarted'
+            ? failedTargets.filter((target) => target.pluginId === root.pluginId) : []));
+        const completedCount = roots.filter((root) => root.state === 'completed'
+            || root.state === 'kept' || root.state === 'partial').length;
+        const failedCount = roots.filter((root) => root.state === 'failed' || root.state === 'partial'
+            || root.state === 'notStarted' || root.state === 'blocked').length;
+        const code = failedCount === 0 ? 'operationSucceeded'
+            : completedCount > 0 ? 'operationPartial' : 'operationFailed';
+        return {
+            code,
+            message: code === 'operationSucceeded' ? '任务已完成。'
+                : code === 'operationPartial' ? '任务只完成了一部分。' : '任务没有完成。',
+            warnings: taskExecution.warnings,
+            recoveryActions: [...new Set(taskExecution.targetResults.flatMap((entry) => entry.recoveryActions ?? []))],
+            ...(taskExecution.operationPlan?.planFingerprint
+                ? { planFingerprint: taskExecution.operationPlan.planFingerprint } : {}),
+            task: {
+                goal: intent.goal,
+                requestedTargets: taskExecution.taskPlan.requestedTargets,
+                rootResults: roots,
+                ...(retryTargets.length > 0 ? { retryTargets } : {}),
+                blockedTargets: taskExecution.taskPlan.blockedTargets,
+            },
+            targets: technicalTargets,
+        };
+    }
     if (intent.kind === 'pluginWrite' || intent.kind === 'pluginWriteBatch') {
         const command = intent.action === 'refreshAndSync' ? 'sync' : intent.action;
         const rawExecution = typeof execution === 'object' && execution !== null
@@ -2995,6 +3681,52 @@ function operationResultSummaryUnsafe(intent, execution) {
             ? pluginWriteBatchFailedRequestedTargets(execution)
             : [];
         const failedRequestedPluginIds = canonicalPluginIds(retryTargets.map((target) => target.pluginId));
+        const requestedTargetKeys = intent.kind === 'pluginWriteBatch'
+            ? new Set(execution.groupResults.flatMap((group) => {
+                const roots = new Set(group.requestedPluginIds);
+                return group.result.targetResults.flatMap((entry) => entry.target.pluginId
+                    && roots.has(entry.target.pluginId)
+                    && entry.target.scope === group.scope
+                    && (group.platform === 'both' || entry.target.platform === group.platform)
+                    ? [[entry.target.pluginId, entry.target.platform, entry.target.scope].join('\0')]
+                    : []);
+            }))
+            : new Set();
+        const rootResults = intent.kind === 'pluginWriteBatch'
+            ? requestedPluginIds.map((pluginId) => {
+                const observed = (result.targetResults ?? []).flatMap((entry) => entry.target.pluginId === pluginId
+                    && requestedTargetKeys.has([
+                        pluginId, entry.target.platform, entry.target.scope,
+                    ].join('\0')) ? [{
+                        pluginId,
+                        platform: entry.target.platform,
+                        scope: entry.target.scope,
+                        state: entry.action === 'skipped' ? 'skipped'
+                            : entry.state === 'failed' ? 'failed'
+                                : entry.action === 'keep' ? 'kept' : 'completed',
+                        relation: 'requested',
+                        ...(entry.errorCode
+                            ? { errorCode: safeDiagnosticCode(entry.errorCode, 'writeFailed') }
+                            : {}),
+                    }] : []);
+                const targets = [...new Map([
+                        ...retryTargets.filter((target) => target.pluginId === pluginId).map((target) => ({
+                            ...target,
+                            state: 'skipped',
+                            relation: 'requested',
+                        })),
+                        ...observed,
+                    ].map((target) => [[target.pluginId, target.platform, target.scope].join('\0'), target]))
+                        .values()];
+                const completed = targets.filter((target) => target.state === 'completed' || target.state === 'kept').length;
+                const failed = targets.length - completed;
+                const state = completed > 0
+                    ? failed > 0 ? 'partial'
+                        : targets.every((target) => target.state === 'kept') ? 'kept' : 'completed'
+                    : failed > 0 ? 'failed' : 'notStarted';
+                return { pluginId, state, targets };
+            })
+            : [];
         return {
             code: result.state === 'succeeded' ? 'operationSucceeded'
                 : result.state === 'partial' ? 'operationPartial' : 'operationFailed',
@@ -3017,6 +3749,7 @@ function operationResultSummaryUnsafe(intent, execution) {
                 batch: {
                     requestedPluginIds,
                     failedRequestedPluginIds,
+                    rootResults,
                     retryTargets,
                     groupCount: execution.groupResults.length,
                 },