@lesliechan721/aw 0.1.0-beta.25 → 0.1.0-beta.27

package/dist/src/tui/controller.js

@@ -1,7 +1,7 @@
 import crypto from 'node:crypto';
 import { CatalogGenerationError } from '../utils/catalog-generation-error.js';
 import { readSafeOperationError } from '../utils/safe-operation-diagnostic.js';
-import { flattenStatusTargets, statusTargetActivation, statusTargetIntent, statusTargetOwnershipState, statusTargetSharedNative, } from '../commands/status-v6.js';
+import { flattenStatusTargets, statusTargetActivation, statusTargetExtensions, statusTargetIntent, statusTargetOwnershipState, statusTargetSharedNative, } 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';
@@ -86,6 +86,86 @@ function reviewPreparationStageLabel(stage) {
         evidence: '准备确认信息',
     }[stage];
 }
+function projectReminderTargetKey(target) {
+    return [target.pluginId, target.platform, target.scope].join('\0');
+}
+export function projectCurrentIntentReminder(status) {
+    const actionableTargets = [];
+    const blockedTargets = [];
+    const unconfirmedTargets = [];
+    const projectRoots = new Map((status.projectIntentRoots ?? []).map((root) => [
+        root.pluginId,
+        new Set(root.platforms),
+    ]));
+    const projectTargets = flattenStatusTargets(status.payload.targets).filter((target) => {
+        const intent = statusTargetIntent(target);
+        return target.scope === 'project'
+            && projectRoots.get(target.pluginId)?.has(target.platform) === true
+            && intent.scopes.includes('project');
+    });
+    for (const target of projectTargets) {
+        if (target.state === 'ready')
+            continue;
+        const reminderTarget = {
+            pluginId: target.pluginId,
+            platform: target.platform,
+            scope: 'project',
+        };
+        const statusReasons = [
+            ...target.reasons,
+            ...(target.sharedReasons ?? []),
+        ];
+        const reasonCodes = [...new Set(statusReasons.flatMap((reason) => [
+                reason.code,
+                ...(reason.rootIssueCode ? [reason.rootIssueCode] : []),
+            ]))].sort((left, right) => left.localeCompare(right, 'en'));
+        const sharedNative = statusTargetSharedNative(target);
+        const activation = statusTargetActivation(target);
+        const extensions = statusTargetExtensions(target);
+        const ownership = statusTargetOwnershipState(target);
+        const blocking = target.state === 'blocked'
+            || [...target.reasons, ...(target.sharedReasons ?? [])]
+                .some((reason) => reason.severity === 'blocking');
+        const unobserved = ownership === 'error'
+            || (!blocking && (sharedNative?.state === 'unobserved'
+                || activation?.evidence === 'unobserved'
+                || reasonCodes.includes('codexSharedNativeUnobserved')
+                || target.components.some((component) => component.metadata?.rootIssueCode === 'codexSharedNativeUnobserved')));
+        const confirmedDifference = ownership === 'absent' || ownership === 'partial'
+            || sharedNative?.state === 'missing' || sharedNative?.state === 'replaceable'
+            || extensions?.state === 'missing' || extensions?.state === 'drifted'
+            || activation?.evidence === 'observed' && activation.project === false
+            || target.components.some((component) => component.kind === 'dependency'
+                && (component.state === 'absent' || component.state === 'incomplete'));
+        if (blocking && confirmedDifference) {
+            blockedTargets.push({ ...reminderTarget, reasonCodes });
+        }
+        else if (!unobserved && target.state === 'needsSync' && confirmedDifference) {
+            actionableTargets.push({ ...reminderTarget, reasonCodes });
+        }
+        else {
+            unconfirmedTargets.push(reminderTarget);
+        }
+    }
+    if (projectTargets.length === 0)
+        return undefined;
+    const canonicalActionable = actionableTargets.sort((left, right) => projectReminderTargetKey(left).localeCompare(projectReminderTargetKey(right), 'en'));
+    const canonicalBlocked = blockedTargets.sort((left, right) => projectReminderTargetKey(left).localeCompare(projectReminderTargetKey(right), 'en'));
+    const canonicalUnconfirmed = unconfirmedTargets.sort((left, right) => projectReminderTargetKey(left).localeCompare(projectReminderTargetKey(right), 'en'));
+    const projectRoot = status.projectRoot ?? projectTargets[0].cwd;
+    const signature = crypto.createHash('sha256').update(JSON.stringify({
+        projectRoot,
+        actionableTargets: canonicalActionable.map(projectReminderTargetKey),
+        blockedTargets: canonicalBlocked.map(projectReminderTargetKey),
+    })).digest('hex');
+    return {
+        projectRoot,
+        signature: `sha256:${signature}`,
+        actionableTargets: canonicalActionable,
+        blockedTargets: canonicalBlocked,
+        unconfirmedTargets: canonicalUnconfirmed,
+    };
+}
 export class TuiOperationBlockedError extends Error {
     code;
     diagnostics;
@@ -140,10 +220,14 @@ function normalizeOperationIntent(intent) {
     }
     if (intent.kind !== 'pluginWriteBatch')
         return intent;
-    if (intent.selection.kind === 'targets') {
+    if (intent.selection.kind === 'targets'
+        || intent.selection.kind === 'currentProjectIntentTargets') {
         return {
             ...intent,
-            selection: { kind: 'targets', targets: canonicalBatchTargets(intent.selection.targets) },
+            selection: {
+                kind: intent.selection.kind,
+                targets: canonicalBatchTargets(intent.selection.targets),
+            },
         };
     }
     if (intent.selection.kind !== 'selected')
@@ -352,9 +436,6 @@ export function pluginWriteTaskFailedRequestedTargets(execution) {
     }));
 }
 function collectOperationSensitiveValues(intent) {
-    if (intent.kind !== 'configSave')
-        return [];
-    const sensitiveKeys = new Set([...(intent.sensitiveKeys ?? []), ...(intent.privateKeys ?? [])]);
     const values = [];
     const visit = (value) => {
         if (typeof value === 'string')
@@ -364,9 +445,21 @@ function collectOperationSensitiveValues(intent) {
         else if (value && typeof value === 'object')
             Object.values(value).forEach(visit);
     };
-    for (const [key, value] of Object.entries(intent.updates ?? {})) {
-        if (sensitiveKeys.has(key))
-            visit(value);
+    const collect = (operation) => {
+        const sensitiveKeys = new Set([
+            ...(operation.sensitiveKeys ?? []),
+            ...(operation.privateKeys ?? []),
+        ]);
+        for (const [key, value] of Object.entries(operation.updates ?? {})) {
+            if (sensitiveKeys.has(key))
+                visit(value);
+        }
+    };
+    if (intent.kind === 'configSave')
+        collect(intent);
+    else if (intent.kind === 'configSaveBatch') {
+        for (const group of intent.groups)
+            collect(group);
     }
     return values;
 }
@@ -399,6 +492,14 @@ function cloneFrozen(value) {
     return deepFreeze(structuredClone(value));
 }
 export function operationEvidenceFingerprint(evidence) {
+    if (evidence.catalogStore) {
+        return crypto.createHash('sha256')
+            .update(JSON.stringify(stableValue({
+            catalog: evidence.catalog,
+            authorizedItems: evidence.catalogStore.authorizedItems,
+        })))
+            .digest('hex');
+    }
     if ('taskPlan' in evidence) {
         const task = evidence.taskPlan;
         return crypto.createHash('sha256')
@@ -470,10 +571,19 @@ export function operationEvidenceFingerprint(evidence) {
     const config = staleEvidence.config
         ? (({ shareability: _shareability, ...identity }) => identity)(staleEvidence.config)
         : undefined;
+    const configBatch = staleEvidence.configBatch
+        ? {
+            groups: staleEvidence.configBatch.groups.map((group) => ({
+                ...group,
+                config: (({ shareability: _shareability, ...identity }) => identity)(group.config),
+            })),
+        }
+        : undefined;
     return crypto.createHash('sha256')
         .update(JSON.stringify(stableValue({
         ...staleEvidence,
         ...(config ? { config } : {}),
+        ...(configBatch ? { configBatch } : {}),
     })))
         .digest('hex');
 }
@@ -545,6 +655,24 @@ function issueCode(error) {
     const prefix = message.split(':', 1)[0];
     return /^[A-Za-z][A-Za-z0-9]*$/u.test(prefix) ? prefix : 'operationBlocked';
 }
+function isPortableInstallReceipt(value) {
+    return typeof value === 'object' && value !== null
+        && value.receiptSchemaVersion === 5
+        && value.command === 'skill:install';
+}
+function completedSinglePluginId(intent, result) {
+    if (result.state !== 'succeeded' || result.summary.warnings?.length)
+        return undefined;
+    if (intent.kind === 'pluginWrite')
+        return intent.originIssue ? undefined : intent.pluginId;
+    const pluginIds = intent.kind === 'pluginWriteBatch'
+        ? result.summary.batch?.requestedPluginIds ?? []
+        : intent.kind === 'pluginWriteTask'
+            ? intent.targets.map((target) => target.pluginId)
+            : [];
+    const unique = [...new Set(pluginIds)];
+    return unique.length === 1 ? unique[0] : undefined;
+}
 export function extractPortableError(error) {
     const typedCode = typeof error === 'object' && error !== null
         && 'code' in error && typeof error.code === 'string'
@@ -572,6 +700,9 @@ export class TuiController {
     #reviewPreparationIntents = new Map();
     #inflightOperations = new Map();
     #pendingReads = new Set();
+    #pluginContent = new Map();
+    #pluginContentInflight = new Map();
+    #pluginContentEpoch = 0;
     #abort = new AbortController();
     #progressUnsubscribe;
     #progressFeed;
@@ -591,6 +722,10 @@ export class TuiController {
     #result;
     #resultAnchor;
     #portableResultSkills;
+    #portableResultReceipt;
+    #portableResultIntent;
+    #completionNotice;
+    #projectIntentReminder;
     #loadError;
     #portableDraft;
     #recoverablePortableDraft;
@@ -700,6 +835,10 @@ export class TuiController {
                             : {}),
                     } }
                 : {}),
+            ...(this.#completionNotice ? { completionNotice: this.#completionNotice } : {}),
+            ...(this.#projectIntentReminder
+                ? { projectIntentReminder: this.#projectIntentReminder }
+                : {}),
         });
     }
     subscribe(listener) {
@@ -828,6 +967,7 @@ export class TuiController {
         this.#result = undefined;
         this.#resultAnchor = undefined;
         this.#portableResultSkills = undefined;
+        this.#completionNotice = undefined;
         this.#progress = { messages: [] };
         this.#progressTargets = [];
         this.#router.resetToRoot();
@@ -1022,6 +1162,7 @@ export class TuiController {
     #project() {
         if (!this.#status)
             return;
+        this.#projectIntentReminder = projectCurrentIntentReminder(this.#status);
         this.#viewModel = buildTuiViewModel({
             status: this.#status.payload,
             pluginSummaries: this.#status.pluginSummaries,
@@ -1031,6 +1172,10 @@ export class TuiController {
             catalogFreshness: this.#catalogFreshness,
             catalogGenerations: this.#catalogGenerations,
             dependencyOverviews: this.#status.dependencyOverviews,
+            contentOverviews: {
+                ...(this.#status.contentOverviews ?? {}),
+                ...Object.fromEntries(this.#pluginContent),
+            },
             portablePluginIds: this.#status.portablePluginIds,
             configStoreInventory: this.#status.configStoreInventory,
         });
@@ -1088,7 +1233,13 @@ export class TuiController {
             this.#router.beginPortableFlow(intent.pluginId);
             return;
         }
-        if (intent.kind === 'configSave' || intent.kind === 'configReset') {
+        if (intent.kind === 'catalogStorePrune') {
+            if (active?.kind === 'catalogStore')
+                return;
+            this.#router.beginFlow('catalogStore', { name: 'catalogStoreOverview' });
+            return;
+        }
+        if (intent.kind === 'configSave' || intent.kind === 'configSaveBatch' || intent.kind === 'configReset') {
             if (active?.kind === 'configEdit')
                 return;
             const route = this.#router.snapshot.current.route;
@@ -1120,6 +1271,15 @@ export class TuiController {
     }
     #stableResultRoute(intent, result) {
         const active = this.#router.activeFlow();
+        if (intent.kind === 'pluginWriteTask' && active?.kind === 'pluginWriteTask'
+            && (active.parentFlowId || active.returnTarget.name === 'pluginWriteTask'
+                && active.returnTarget.goal !== intent.goal)) {
+            return this.#normalizeRoute(active.returnTarget);
+        }
+        const completedPluginId = completedSinglePluginId(intent, result);
+        if (completedPluginId) {
+            return this.#normalizeRoute({ name: 'pluginDetail', pluginId: completedPluginId });
+        }
         if (intent.kind === 'pluginWriteTask'
             && result.state === 'succeeded'
             && 'returnRoute' in result
@@ -1128,10 +1288,15 @@ export class TuiController {
             && result.returnRoute.batchOrigin?.owner === 'batch-write') {
             return { name: 'pluginList', mode: 'installed' };
         }
+        if (intent.kind === 'portableInstall' && result.state === 'succeeded') {
+            return this.#normalizeRoute({ name: 'pluginDetail', pluginId: intent.pluginId });
+        }
+        if (intent.kind === 'catalogStorePrune')
+            return { name: 'catalogStoreOverview' };
         if (active?.parentFlowId)
             return this.#normalizeRoute(active.returnTarget);
         if (active && (intent.kind === 'portableInstall'
-            || intent.kind === 'configSave' || intent.kind === 'configReset')) {
+            || intent.kind === 'configSave' || intent.kind === 'configSaveBatch' || intent.kind === 'configReset')) {
             return this.#normalizeRoute(active.returnTarget);
         }
         if (intent.kind === 'pluginWrite') {
@@ -1139,11 +1304,18 @@ export class TuiController {
                 return { name: 'issueList' };
             return this.#normalizeRoute({ name: 'pluginDetail', pluginId: intent.pluginId });
         }
+        if (intent.kind === 'pluginWriteBatch' && intent.selection.kind === 'targets') {
+            const pluginIds = [...new Set(intent.selection.targets.map((target) => target.pluginId))];
+            if (pluginIds.length === 1) {
+                return this.#normalizeRoute({ name: 'pluginDetail', pluginId: pluginIds[0] });
+            }
+        }
         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') {
+        if (intent.kind === 'portableInstall' || intent.kind === 'configSave'
+            || intent.kind === 'configSaveBatch' || intent.kind === 'configReset') {
             return this.#normalizeRoute({ name: 'pluginDetail', pluginId: intent.pluginId });
         }
         if (intent.kind === 'sourceMutation' && intent.action === 'update') {
@@ -1188,7 +1360,9 @@ export class TuiController {
             ? {
                 ...structuredClone(intent),
                 selection: {
-                    kind: 'targets',
+                    kind: intent.selection.kind === 'currentProjectIntentRoots'
+                        || intent.selection.kind === 'currentProjectIntentTargets'
+                        ? 'currentProjectIntentTargets' : 'targets',
                     targets: structuredClone(result.summary.batch.retryTargets),
                 },
             }
@@ -1214,13 +1388,45 @@ export class TuiController {
             && result.returnRoute.batchOrigin?.owner === 'batch-write'
             ? result.returnRoute.batchOrigin.flowId
             : undefined;
+        const completedPluginId = completedSinglePluginId(intent, result);
+        if (completedPluginId && target.name === 'pluginDetail') {
+            this.#recordTerminalResult();
+            const action = intent.kind === 'pluginWrite' || intent.kind === 'pluginWriteBatch'
+                ? intent.action : 'sync';
+            this.#completionNotice = {
+                pluginId: completedPluginId,
+                title: intent.kind === 'pluginWriteTask'
+                    ? intent.goal === 'update' ? '插件更新完成' : '插件恢复完成'
+                    : action === 'uninstall' ? '插件卸载完成'
+                        : action === 'install' ? '插件安装完成'
+                            : action === 'reinstall' ? '插件重新安装完成'
+                                : action === 'refreshAndSync' ? '插件更新完成'
+                                    : action === 'cleanup' ? '插件清理完成' : '插件同步完成',
+                description: action === 'uninstall'
+                    ? '所选实际位置已处理。插件设置保持不变。'
+                    : '状态已重新检查。下方详情显示当前实际位置。',
+                ...(result.operationRecordId ? { operationRecordId: result.operationRecordId } : {}),
+            };
+            const finished = this.#router.finishFlow(target);
+            if (!finished)
+                this.#router.replace(target);
+            return;
+        }
+        const portableParentFlowId = result.state === 'succeeded'
+            && intent.kind === 'portableInstall'
+            && this.#router.activeFlow()?.parentFlowId;
         const finished = batchFlowId
             ? this.#router.finishFlowById(batchFlowId, 'batchWrite', target, terminal)
-            : this.#router.finishFlow(target, terminal);
+            : portableParentFlowId
+                ? this.#router.finishFlowById(portableParentFlowId, 'pluginInstall', target, terminal)
+                : this.#router.finishFlow(target, terminal);
         if (!finished)
             this.#router.replace(terminal);
     }
     #applyStatus(status) {
+        this.#pluginContentEpoch += 1;
+        this.#pluginContent.clear();
+        this.#pluginContentInflight.clear();
         this.#status = structuredClone(status);
         this.#statusReadAtMs = this.dependencies.now?.() ?? Date.now();
         if (status.catalogGenerations) {
@@ -1287,6 +1493,9 @@ export class TuiController {
         this.#assertAcceptingActions();
         this.dependencies.beginCatalogSession?.();
         const generation = ++this.#generation;
+        this.#pluginContentEpoch += 1;
+        this.#pluginContent.clear();
+        this.#pluginContentInflight.clear();
         this.#phase = 'loading';
         this.#publish();
         let status;
@@ -1320,7 +1529,7 @@ export class TuiController {
             && this.#router.activeFlow()?.kind !== 'sourceEdit') {
             this.#router.beginFlow('sourceEdit', this.#router.snapshot.current.route);
         }
-        this.#router.push(route, context);
+        this.#router.push(route.name === 'pluginPreview' ? this.#normalizeRoute(route) : route, context);
         this.#publish();
     }
     hasPortableSkills(pluginId) {
@@ -1439,6 +1648,14 @@ export class TuiController {
         this.#portableDraft.canContinue = this.#portableDraft.totalCount > 0;
         this.#publish();
     }
+    clearPortableSkills() {
+        if (!this.#portableDraft)
+            return;
+        this.#portableDraft.candidates = this.#portableDraft.candidates.map((candidate) => ({ ...candidate, selected: false }));
+        this.#portableDraft.selectedCount = 0;
+        this.#portableDraft.canContinue = false;
+        this.#publish();
+    }
     setPortableAgentMode(mode, requestedAgents = []) {
         if (!this.#portableDraft)
             return;
@@ -1483,6 +1700,63 @@ export class TuiController {
         const intent = this.#portableInstallIntent();
         return this.startReviewPreparation(intent, this.#router.portableOrigin(intent.pluginId));
     }
+    async recheckPortableResult() {
+        this.#assertAcceptingActions();
+        if (this.#router.snapshot.current.route.name !== 'result'
+            || this.#result?.operationKind !== 'portableInstall'
+            || !this.#portableResultReceipt
+            || !this.#portableResultIntent
+            || !this.dependencies.recheckPortableInstall) {
+            throw new TuiOperationBlockedError('portableRecheckUnavailable', '当前结果不能执行只读复查。');
+        }
+        const checked = await this.#trackRead(this.dependencies.recheckPortableInstall(structuredClone(this.#portableResultReceipt), this.#abort.signal));
+        this.#portableResultReceipt = structuredClone(checked);
+        const summary = operationResultSummary(this.#portableResultIntent, checked);
+        const previous = this.#result;
+        this.#result = {
+            state: checked.status === 'succeeded' ? 'succeeded' : 'partial',
+            operationId: previous.operationId,
+            summary: {
+                ...summary,
+                elapsedMs: 'summary' in previous && previous.summary?.elapsedMs !== undefined
+                    ? previous.summary.elapsedMs : summary.elapsedMs,
+            },
+            operationKind: 'portableInstall',
+            pluginId: this.#portableResultIntent.pluginId,
+            returnRoute: 'returnRoute' in previous && previous.returnRoute
+                ? structuredClone(previous.returnRoute)
+                : { name: 'pluginDetail', pluginId: this.#portableResultIntent.pluginId },
+        };
+        this.#publish();
+        return cloneFrozen(checked);
+    }
+    startPortableRetryReviewPreparation() {
+        this.#assertAcceptingActions();
+        const receipt = this.#portableResultReceipt;
+        const original = this.#portableResultIntent;
+        if (this.#router.snapshot.current.route.name !== 'result' || !receipt || !original) {
+            throw new TuiOperationBlockedError('portableRetryUnavailable', '当前结果不能准备精确重试。');
+        }
+        if ((receipt.verification.unknown?.length ?? 0) > 0) {
+            throw new TuiOperationBlockedError('portableRetryNotExact', '结果仍有未知目标。请先只读复查。');
+        }
+        const retryPairs = receipt.verification.missing;
+        if (retryPairs.length === 0 || retryPairs.some((target) => !target.agent)) {
+            throw new TuiOperationBlockedError('portableRetryNotExact', '没有可绑定到 Skill 与 Agent 的精确失败目标。');
+        }
+        const intent = {
+            kind: 'portableInstall',
+            pluginId: original.pluginId,
+            scope: original.scope,
+            selectedSkills: [...new Set(retryPairs.map((target) => target.skill))],
+            requestedAgents: [...new Set(retryPairs.flatMap((target) => target.agent ? [target.agent] : []))],
+            retry: { receipt: structuredClone(receipt) },
+        };
+        return this.startReviewPreparation(intent, {
+            name: 'pluginDetail',
+            pluginId: original.pluginId,
+        });
+    }
     discardPortableDraft() {
         this.#cancelPortableRequest();
         this.#portableDraft = undefined;
@@ -1494,11 +1768,11 @@ export class TuiController {
         this.#cancelInstallPlacementRequest();
         const current = this.#router.snapshot.current.route;
         if (current.name === 'portableBlocker' && current.code === 'requiredConfigMissing'
-            && route.name === 'configLayer' && route.pluginId === current.pluginId) {
+            && route.name === 'configFields' && route.pluginId === current.pluginId) {
             this.#portableRepreparePluginId = current.pluginId;
         }
         this.#discardPortableDraftForRoute(route);
-        this.#router.replace(route, context);
+        this.#router.replace(route.name === 'pluginPreview' ? this.#normalizeRoute(route) : route, context);
         this.#publish();
     }
     beginConfigFlow(pluginId) {
@@ -1660,6 +1934,7 @@ export class TuiController {
             this.#result = undefined;
             this.#resultAnchor = undefined;
             this.#portableResultSkills = undefined;
+            this.#completionNotice = undefined;
             this.#publish();
             return;
         }
@@ -1671,7 +1946,8 @@ export class TuiController {
             return;
         }
         if (this.#result?.state === 'succeeded'
-            && (this.#result.operationKind === 'configSave' || this.#result.operationKind === 'configReset')
+            && (this.#result.operationKind === 'configSave' || this.#result.operationKind === 'configSaveBatch'
+                || this.#result.operationKind === 'configReset')
             && this.#result.pluginId
             && this.#router.resetConfigFlow(this.#result.pluginId, target)) {
             this.#result = undefined;
@@ -1687,6 +1963,7 @@ export class TuiController {
         this.#result = undefined;
         this.#resultAnchor = undefined;
         this.#portableResultSkills = undefined;
+        this.#completionNotice = undefined;
         this.#recoverableInstallPlacementDraft = undefined;
         this.#recoverablePortableDraft = undefined;
         this.#publish();
@@ -1698,7 +1975,8 @@ export class TuiController {
             return;
         const returnRoute = this.#normalizeRoute(result.returnRoute);
         this.#router.back();
-        const kind = result.operationKind === 'configSave' || result.operationKind === 'configReset'
+        const kind = result.operationKind === 'configSave' || result.operationKind === 'configSaveBatch'
+            || result.operationKind === 'configReset'
             ? 'configEdit'
             : result.operationKind === 'portableInstall'
                 ? 'portableInstall'
@@ -1728,6 +2006,7 @@ export class TuiController {
         if (readOnlyHistoryRoute && this.#router.activeFlow()?.kind === 'portableInstall')
             return;
         const portableRoute = route.name === 'portableSkillSelect'
+            || route.name === 'portableSkillSummary'
             || route.name === 'portableDependencies'
             || route.name === 'portableAgentMode'
             || route.name === 'portableAgentInput'
@@ -1962,18 +2241,73 @@ export class TuiController {
     }
     listPlugins(options) {
         const query = options.query?.trim().toLocaleLowerCase('en');
-        const catalogPluginIds = new Set(this.#status?.pluginSummaries.map((plugin) => plugin.pluginId));
         return cloneFrozen((this.#viewModel?.plugins ?? []).filter((plugin) => (!options.sourceId || plugin.sourceId === options.sourceId)
-            && (options.mode === 'browse' ? catalogPluginIds.has(plugin.pluginId)
-                : hasInstalledPlacement(plugin) || plugin.savedConfigScopes.length > 0)
+            && (options.installFilter !== 'installed'
+                || hasInstalledPlacement(plugin))
             && (options.installFilter !== 'uninstalled' || !hasInstalledPlacement(plugin))
             && (options.installFilter !== 'updateAvailable' || plugin.update?.state === 'available')
+            && (options.installFilter !== 'attention'
+                || plugin.aggregateStatus === 'needsAttention' || plugin.aggregateStatus === 'unavailable'
+                || plugin.primaryAttention !== undefined || plugin.sourceUnavailable === true
+                || plugin.capabilityUnsupported === true)
             && (!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;
     }
+    getPluginContentOverview(pluginId) {
+        const overview = this.#viewModel?.contentOverviews[pluginId];
+        return overview ? cloneFrozen(overview) : undefined;
+    }
+    getPluginContentState(pluginId) {
+        if (this.#viewModel?.contentOverviews[pluginId])
+            return 'ready';
+        return this.#pluginContentInflight.has(pluginId) ? 'loading' : 'idle';
+    }
+    loadPluginContent(pluginId) {
+        if (this.#viewModel?.contentOverviews[pluginId])
+            return Promise.resolve();
+        const current = this.#pluginContentInflight.get(pluginId);
+        if (current)
+            return current;
+        const loader = this.dependencies.loadPluginContent;
+        if (!loader)
+            return Promise.resolve();
+        const generation = this.#generation;
+        const contentEpoch = this.#pluginContentEpoch;
+        const promise = this.#trackRead(loader(pluginId, this.#abort.signal))
+            .then((overview) => {
+            if (this.#disposed || generation !== this.#generation
+                || contentEpoch !== this.#pluginContentEpoch)
+                return;
+            this.#pluginContent.set(pluginId, structuredClone(overview));
+            this.#project();
+        })
+            .catch(() => {
+            if (this.#disposed || generation !== this.#generation
+                || contentEpoch !== this.#pluginContentEpoch)
+                return;
+            this.#pluginContent.set(pluginId, {
+                pluginId,
+                pluginVersion: '待确认',
+                catalogVersion: '待确认',
+                evidence: 'unavailable',
+                items: [],
+                notices: ['当前无法安全读取这个插件的内容。'],
+            });
+            this.#project();
+        })
+            .finally(() => {
+            if (this.#pluginContentInflight.get(pluginId) !== promise)
+                return;
+            this.#pluginContentInflight.delete(pluginId);
+            this.#publish();
+        });
+        this.#pluginContentInflight.set(pluginId, promise);
+        this.#publish();
+        return promise;
+    }
     getPluginSourceIdentity(pluginId) {
         return flattenStatusTargets(this.#status?.payload.targets ?? []).find((target) => target.pluginId === pluginId)?.sourceIdentity;
     }
@@ -2207,7 +2541,9 @@ export class TuiController {
         this.#publish();
     }
     startPluginWriteBatchReview(intent) {
-        return this.startReviewPreparation(intent, { name: 'batchPlacement' });
+        return this.startReviewPreparation(intent, intent.action === 'install'
+            ? { name: 'batchInstallScope' }
+            : { name: 'batchPlacement' });
     }
     startPluginWriteTaskReview(intent, returnRoute) {
         return this.startReviewPreparation(intent, returnRoute);
@@ -2347,6 +2683,13 @@ export class TuiController {
         }
         return cloneFrozen(await this.#trackRead(this.dependencies.inspectSourceRemoval(sourceId, this.#abort.signal)));
     }
+    async inspectCatalogStore() {
+        this.#assertAcceptingActions();
+        if (!this.dependencies.inspectCatalogStore) {
+            throw new TuiOperationBlockedError('catalogStoreUnavailable', 'Catalog 本地存储检查不可用。');
+        }
+        return cloneFrozen(await this.#trackRead(this.dependencies.inspectCatalogStore(this.#abort.signal)));
+    }
     async getConfigGroups(pluginId, layer) {
         this.#assertAcceptingActions();
         if (!this.dependencies.getConfigGroups) {
@@ -2412,6 +2755,7 @@ export class TuiController {
     }
     startReviewPreparation(intent, returnRoute) {
         this.#assertAcceptingActions();
+        this.#completionNotice = undefined;
         intent = normalizeOperationIntent(intent);
         if (intent.kind === 'catalogGeneration' && !intent.sourceMutation) {
             const blockReason = this.catalogSourceRecoveryBlockReason(intent);
@@ -2492,10 +2836,25 @@ export class TuiController {
             }
         }
         if (intent.kind === 'pluginWriteBatch') {
-            if (intent.selection.kind === 'currentProjectIntentRoots'
+            if ((intent.selection.kind === 'currentProjectIntentRoots'
+                || intent.selection.kind === 'currentProjectIntentTargets')
                 && (intent.action !== 'sync' || intent.scope !== 'project')) {
                 throw new TuiOperationBlockedError('batchSelectionInvalid', '当前项目全部同步只支持 project scope sync。');
             }
+            if (intent.selection.kind === 'currentProjectIntentTargets') {
+                const targets = intent.selection.targets;
+                const canonical = [...new Map(targets.map((target) => [
+                        projectReminderTargetKey(target), target,
+                    ])).values()].sort((left, right) => projectReminderTargetKey(left)
+                    .localeCompare(projectReminderTargetKey(right), 'en'));
+                if (targets.length === 0
+                    || targets.some((target) => target.scope !== 'project')
+                    || JSON.stringify(targets) !== JSON.stringify(canonical)) {
+                    throw new TuiOperationBlockedError('batchSelectionInvalid', '当前项目同步目标必须是非空、规范且精确的 project 目标集合。');
+                }
+                for (const target of targets)
+                    sourceIdFromPluginId(target.pluginId);
+            }
             if (intent.selection.kind === 'selected') {
                 const canonical = canonicalPluginIds(intent.selection.pluginIds);
                 if (canonical.length === 0) {
@@ -2513,6 +2872,8 @@ export class TuiController {
     #reviewPreparationLabel(intent) {
         if (intent.kind === 'catalogSourcesRecovery')
             return 'Catalog 来源配置';
+        if (intent.kind === 'catalogStorePrune')
+            return 'Catalog 本地存储';
         if (intent.kind === 'pluginWriteTask')
             return `${intent.targets.length} 个安装位置`;
         if (intent.kind === 'pluginWriteBatch') {
@@ -2686,7 +3047,8 @@ export class TuiController {
     }
     async #logOperationError(error, code, intent) {
         await this.#logErrorSafe(error, code, {
-            privateConfigOperation: intent.kind === 'configSave' || intent.kind === 'configReset'
+            privateConfigOperation: intent.kind === 'configSave' || intent.kind === 'configSaveBatch'
+                || intent.kind === 'configReset'
                 || intent.kind === 'sourceMutation',
         });
     }
@@ -2863,7 +3225,8 @@ export class TuiController {
                     : 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 来源配置',
+                            : 'sourceId' in ticket.intent ? ticket.intent.sourceId ?? 'Catalog 管理'
+                                : ticket.intent.kind === 'catalogStorePrune' ? 'Catalog 本地存储' : 'Catalog 来源配置',
                 phase: '验证当前状态',
             },
         };
@@ -2932,6 +3295,10 @@ export class TuiController {
             const execution = ticket.intent.kind === 'catalogGeneration'
                 ? await this.dependencies.executeIntent(structuredClone(ticket.intent), structuredClone(ticket.evidence), this.#abort.signal)
                 : await this.dependencies.executeIntent(structuredClone(ticket.intent), structuredClone(ticket.evidence));
+            if (ticket.intent.kind === 'portableInstall' && isPortableInstallReceipt(execution)) {
+                this.#portableResultReceipt = structuredClone(execution);
+                this.#portableResultIntent = structuredClone(ticket.intent);
+            }
             const executionProjection = projectExecutionDiagnostics(execution, `${this.#sessionEpoch}:${operationId}`, collectOperationSensitiveValues(ticket.intent), ticket.intent.kind);
             this.#operationDiagnostics.set(operationId, {
                 ...executionProjection,
@@ -2989,8 +3356,12 @@ export class TuiController {
                     return this.#detachedBlocked(operationId, ticket.intent);
                 const configCommitted = typeof execution === 'object'
                     && execution !== null
-                    && execution.configWrite === 'succeeded';
-                if ((ticket.intent.kind === 'configSave' || ticket.intent.kind === 'configReset')
+                    && (execution.configWrite === 'succeeded'
+                        || Array.isArray(execution.groups)
+                            && (execution.groups
+                                .some((group) => group.configSaved)));
+                if ((ticket.intent.kind === 'configSave' || ticket.intent.kind === 'configSaveBatch'
+                    || ticket.intent.kind === 'configReset')
                     && configCommitted) {
                     const baseSummary = operationResultSummary(ticket.intent, execution);
                     const elapsedMs = Math.max(0, (this.dependencies.now?.() ?? Date.now()) - startedAtMs);
@@ -3095,6 +3466,7 @@ export class TuiController {
                     navigation: 'result',
                     returnRoute: ticket.returnRoute,
                     ...(ticket.intent.kind === 'pluginWriteBatch' || ticket.intent.kind === 'pluginWriteTask'
+                        || ticket.intent.kind === 'pluginWrite' && ticket.intent.action === 'uninstall'
                         || dependencyFailure || dependencyStillRequired
                         ? { summary: pluginSummary } : {}),
                     ...(ticket.intent.kind !== 'pluginWriteBatch' && ticket.intent.kind !== 'pluginWriteTask'
@@ -3149,6 +3521,15 @@ export class TuiController {
                     this.#publish();
                     return cloneFrozen(result);
                 }
+                if (ticket.intent.kind === 'configSaveBatch') {
+                    return this.#setBlocked(operationId, 'operationFailed', {
+                        intent: ticket.intent,
+                        navigation: 'result',
+                        returnRoute: ticket.returnRoute,
+                        summary,
+                        writeMayHaveCompleted: false,
+                    });
+                }
                 return this.#setBlocked(operationId, 'operationFailed', {
                     intent: ticket.intent,
                     navigation: 'result',
@@ -3176,8 +3557,13 @@ export class TuiController {
                                 : { name: 'sourceDetail', sourceId: ticket.intent.sourceId }
                             : ticket.returnRoute)),
             };
-            if ((ticket.intent.kind === 'configSave' || ticket.intent.kind === 'configReset')
-                && this.#portableRepreparePluginId === ticket.intent.pluginId) {
+            const configResultNeedsAttention = result.state === 'succeeded' && (result.summary.messages?.some((message) => message.startsWith('警告：')
+                || message === '提示：其它项目没有被扫描，可能需要在对应项目目录中运行 aw sync。') ?? false);
+            if ((ticket.intent.kind === 'configSave' || ticket.intent.kind === 'configSaveBatch'
+                || ticket.intent.kind === 'configReset')
+                && this.#portableRepreparePluginId === ticket.intent.pluginId
+                && result.state === 'succeeded'
+                && !configResultNeedsAttention) {
                 this.#operationDiagnostics.delete(operationId);
                 this.#portableRepreparePluginId = undefined;
                 this.#activeReview = undefined;
@@ -3471,6 +3857,20 @@ export class TuiController {
     }
 }
 function operationResultSummaryUnsafe(intent, execution) {
+    if (intent.kind === 'catalogStorePrune') {
+        const result = execution;
+        return {
+            code: result.overallState === 'succeeded' ? 'operationSucceeded' : 'operationPartial',
+            message: result.overallState === 'succeeded'
+                ? `Catalog 本地存储清理完成；删除 ${result.deleted.length} 项。`
+                : `Catalog 本地存储部分清理完成；删除 ${result.deleted.length} 项。`,
+            messages: [
+                result.deletedBytes === null ? '已删除大小未知。' : `已删除 ${result.deletedBytes} bytes。`,
+                `保留 ${result.retained.length} 项。`,
+                ...(result.errors.length > 0 ? [`${result.errors.length} 项未能安全删除。`] : []),
+            ],
+        };
+    }
     if (intent.kind === 'catalogSourcesRecovery') {
         const result = execution;
         return {
@@ -3519,9 +3919,10 @@ function operationResultSummaryUnsafe(intent, execution) {
     }
     if (intent.kind === 'portableInstall') {
         const receipt = execution;
-        const verificationUnknown = receipt.failures.some((failure) => failure.code === 'portableSkillsCliVerificationFailed'
-            && receipt.verification.records.length === 0
-            && receipt.verification.missing.length === 0);
+        const verificationUnknown = (receipt.verification.unknown?.length ?? 0) > 0
+            || receipt.failures.some((failure) => failure.code === 'portableSkillsCliVerificationFailed'
+                && receipt.verification.records.length === 0
+                && receipt.verification.missing.length === 0);
         return {
             code: receipt.status === 'succeeded' ? 'operationSucceeded'
                 : receipt.status === 'partial' ? 'operationPartial' : 'operationFailed',
@@ -3540,7 +3941,9 @@ function operationResultSummaryUnsafe(intent, execution) {
                 scope: receipt.scope,
                 materializationDigest: receipt.materializationDigest,
                 skillsCliVersion: receipt.skillsCliVersion,
+                verified: receipt.verification.records,
                 missing: receipt.verification.missing,
+                unknown: receipt.verification.unknown ?? [],
                 verificationUnknown,
                 ...(receipt.failures[0]?.recovery ? { recovery: receipt.failures[0].recovery } : {}),
                 ...(receipt.failures[0]?.code ? { failureCode: receipt.failures[0].code } : {}),
@@ -3805,6 +4208,62 @@ function operationResultSummaryUnsafe(intent, execution) {
             })),
         };
     }
+    if (intent.kind === 'configSaveBatch') {
+        const batch = execution;
+        const savedCount = batch.groups.filter((group) => group.configSaved).length;
+        const failedCount = batch.groups.filter((group) => group.status === 'failed').length;
+        const retryScopes = batch.groups.filter((group) => group.configSaved && group.applyStatus === 'failed' && group.errorCode !== 'invalidConfig');
+        const invalidConfig = savedCount === batch.groups.length
+            && batch.groups.some((group) => group.configSaved && group.errorCode === 'invalidConfig')
+            && retryScopes.length === 0;
+        const publicWarnings = [...new Set(batch.groups.flatMap((group) => {
+                if (!group.execution || typeof group.execution !== 'object'
+                    || !Array.isArray(group.execution.warnings))
+                    return [];
+                return group.execution.warnings.filter((warning) => typeof warning === 'string' && warning.startsWith('projectConfigShareabilityUnverified:'));
+            }))];
+        const otherProjectsMayRequireSync = batch.groups.some((group) => group.scope === 'user' && group.execution && typeof group.execution === 'object'
+            && group.execution.otherProjectsMayRequireSync === true);
+        return {
+            code: failedCount > 0
+                ? savedCount > 0 ? 'operationPartial' : 'operationFailed'
+                : 'operationSucceeded',
+            message: invalidConfig
+                ? '设置已保存，但没有应用。当前配置仍无效。'
+                : failedCount > 0
+                    ? savedCount > 0
+                        ? `已保存 ${savedCount} 个设置层；${failedCount} 个设置层失败。`
+                        : '设置没有保存。'
+                    : '设置已保存。',
+            pluginId: intent.pluginId,
+            configApplyRetryAvailable: retryScopes.length > 0,
+            ...(invalidConfig ? { configApplySkippedReason: 'invalidConfig' } : {}),
+            configApplied: intent.apply
+                ? batch.groups.some((group) => group.applyStatus === 'succeeded')
+                : false,
+            configGroups: batch.groups.map((group) => ({
+                scope: group.scope,
+                configSaved: group.configSaved,
+                applyRequested: group.applyRequested,
+                applyStatus: group.applyStatus,
+                ...(group.errorCode ? { errorCode: safeDiagnosticCode(group.errorCode, 'configWriteFailed') } : {}),
+            })),
+            messages: [
+                ...batch.groups.map((group) => {
+                    const label = group.scope === 'project' ? '当前项目' : '个人默认';
+                    return group.configSaved
+                        ? `${label}已保存${group.errorCode === 'invalidConfig'
+                            ? '，但当前配置无效，未应用'
+                            : group.applyStatus === 'failed' ? '，但应用失败' : ''}。`
+                        : `${label}保存失败。`;
+                }),
+                ...publicWarnings.map((warning) => `警告：${warning}`),
+                ...(otherProjectsMayRequireSync
+                    ? ['提示：其它项目没有被扫描，可能需要在对应项目目录中运行 aw sync。']
+                    : []),
+            ],
+        };
+    }
     if (intent.kind === 'configSave' || intent.kind === 'configReset') {
         const rawApply = typeof execution === 'object' && execution !== null
             && typeof execution.apply === 'object'
@@ -3878,6 +4337,7 @@ function operationResultSummaryUnsafe(intent, execution) {
             configScope: intent.scope,
             configApplyRetryAvailable: intent.kind === 'configSave'
                 && intent.apply && !invalidConfig && (applyState === 'partial' || applyState === 'unavailable'),
+            ...(intent.kind === 'configSave' && intent.retryApply ? { configRetryApply: true } : {}),
             ...(publicMessages.length > 0 ? { messages: publicMessages } : {}),
             ...(intent.kind === 'configSave'
                 ? { configApplied: applyState === 'succeeded' || applyState === 'partial' }