@lesliechan721/aw 0.1.0-beta.34 → 0.1.0-beta.36

package/dist/src/tui/controller.d.ts

@@ -11,7 +11,9 @@ import type { OperationPlan } from '../commands/operation-plan.js';
 import type { RebuildProgressFeed, RebuildProgressSnapshot } from '../output/rebuild-progress.js';
 import { type ConfigPageViewModel, type ConfigGroupViewModel, type InstallPlacementDraftViewModel, type PluginListItemViewModel, type PluginDependencyOverviewViewModel, type PortableSkillSelectionViewModel, type SourceHealthViewModel, type SourceDetailViewModel, type TuiViewModel, type UserIssueCategory, type UserIssueViewModel } from './model.js';
 import type { PluginContentOverview } from './plugin-content.js';
+import { type PluginDetailSubject } from './plugin-detail.js';
 import { OperationHistoryStore, type OperationDiagnosticDetail, type OperationEffectFacts, type OperationHistorySummary, type OperationReportPreview, type SafeOperationDiagnostic, type SaveOperationReportResult } from './operation-history.js';
+import { type ProjectInventoryRoot, type ProjectInventoryViewModel } from './project-inventory.js';
 import { type ConfigInvalidStoreEvidence, type PluginInstallFilter, type PortableBlockerCode, type TuiPageContext, type TuiRoute, type TuiRouterSnapshot } from './router.js';
 import { type CatalogSourceGenerationViewModel } from './catalog-generation.js';
 import type { CatalogSourceFreshnessViewModel } from './catalog-freshness.js';
@@ -136,6 +138,7 @@ export interface ConfigOperationChange {
     }>;
 }
 export interface ConfigSaveBatchGroup {
+    editEvidence?: Record<string, import('./model.js').ConfigEditEvidence>;
     scope: Scope;
     updates?: Record<string, unknown>;
     removeKeys?: string[];
@@ -290,6 +293,7 @@ export interface OperationEvidence {
     targetFingerprint?: string;
     offlineCleanup?: OfflineCleanupTargetEvidence;
     offlineCleanupPlans?: OfflineCleanupTargetEvidence[];
+    removedPluginCleanupIds?: string[];
     dependencyPlan?: ReconcileOperationPlan;
     codexReconcilePlans?: CodexReconcilePlan[];
     operationPlan?: OperationPlan;
@@ -382,6 +386,10 @@ export interface OperationReviewModel {
         version?: string;
     };
     changes: OperationReviewChange[];
+    configImpact?: {
+        state: 'known' | 'unknown';
+        affectedTargetCount: number;
+    };
     confirmationDetails?: string[];
     technicalDetails?: string[];
     equivalentCommand?: string;
@@ -778,6 +786,12 @@ export interface TuiControllerSnapshot {
         operationRecordId?: string;
     };
     projectIntentReminder?: ProjectIntentReminder;
+    projectInventory?: ProjectInventoryViewModel;
+    projectInventoryRefresh: {
+        state: 'idle' | 'checking' | 'error';
+        checkedAtMs?: number;
+        errorCode?: string;
+    };
     projectDeclarationAbsent?: boolean;
     projectIntentIssue?: {
         state: 'invalid' | 'unavailable';
@@ -833,6 +847,9 @@ export declare class TuiController {
         discardDrafts?: boolean;
     }): boolean;
     load(): Promise<void>;
+    listProjectInventoryRoots(section?: 'declared' | 'extraInstalled'): ProjectInventoryRoot[];
+    getProjectInventoryRoot(pluginId: string): ProjectInventoryRoot | undefined;
+    refreshProjectInventory(): Promise<boolean>;
     push(route: TuiRoute, context?: TuiPageContext): void;
     hasPortableSkills(pluginId: string): boolean;
     preparePortableInstall(pluginId: string, navigation?: 'push' | 'replace'): Promise<PortableSkillSelectionViewModel>;
@@ -881,6 +898,7 @@ export declare class TuiController {
         installFilter?: PluginInstallFilter;
     }): PluginListItemViewModel[];
     getPluginOverview(pluginId: string): PluginListItemViewModel | undefined;
+    getPluginDetailSubject(pluginId: string): PluginDetailSubject | undefined;
     getPluginContentOverview(pluginId: string): PluginContentOverview | undefined;
     getPluginContentState(pluginId: string): 'idle' | 'loading' | 'ready';
     loadPluginContent(pluginId: string): Promise<void>;

package/dist/src/tui/controller.js

@@ -5,11 +5,13 @@ import { flattenStatusTargets, statusTargetActivation, statusTargetExtensions, s
 import { buildRebuildReceiptJson, requestedIntentAction } from '../output/command-receipt.js';
 import { buildOperationResultModel } from '../commands/operation-planner.js';
 import { buildOperationReviewProjection } from './operation-review-planner.js';
-import { buildTuiViewModel, dependencyPlacementTargets, hasInstalledPlacement, } from './model.js';
+import { buildTuiViewModel, dependencyPlacementTargets, } from './model.js';
+import { buildPluginDetailSubject } from './plugin-detail.js';
 import { safeDiagnosticCode, sanitizeDiagnosticText } from './diagnostics.js';
 import { projectExecutionDiagnostics, projectThrownOperationDiagnostic } from './diagnostic-projection.js';
 import { OperationHistoryStore, } from './operation-history.js';
 import { targetHasArtifactCollision } from '../utils/target-eligibility.js';
+import { buildProjectInventory, hasStatusInstallationEvidence, } from './project-inventory.js';
 import { TuiRouter, } from './router.js';
 import { normalizeTuiRoute } from './screen-registry.js';
 import { CatalogSourcesSession } from './catalog-sources/session.js';
@@ -36,7 +38,10 @@ export function pluginWriteBatchTargets(action, pluginIds, statusTargets) {
         const activation = statusTargetActivation(target);
         const hasManagedOutput = ownership !== 'absent';
         const hasCleanupEvidence = ownership === 'present' || ownership === 'partial'
-            || intent.relation === 'managed';
+            || intent.relation === 'managed'
+            || target.reasons.some((reason) => reason.code === 'removedPluginCleanupRequired')
+            || (target.platform === 'codex' && activation?.evidence === 'observed'
+                && (activation.user !== undefined || activation.project !== undefined));
         if (action === 'sync' || action === 'reinstall') {
             intent.scopes.forEach((scope) => add(target, scope));
             if (hasManagedOutput)
@@ -61,9 +66,9 @@ export function pluginWriteBatchTargets(action, pluginIds, statusTargets) {
         else if (hasCleanupEvidence) {
             add(target, target.scope);
             if (target.platform === 'codex') {
-                if (activation?.user === true)
+                if (activation?.user !== undefined)
                     add(target, 'user');
-                if (activation?.project === true)
+                if (activation?.project !== undefined)
                     add(target, 'project');
             }
         }
@@ -731,6 +736,9 @@ export class TuiController {
     #portableResultRecheck;
     #completionNotice;
     #projectIntentReminder;
+    #projectInventory;
+    #projectInventoryRefresh = { state: 'idle' };
+    #projectInventoryRefreshToken = 0;
     #loadError;
     #portableDraft;
     #recoverablePortableDraft;
@@ -850,6 +858,8 @@ export class TuiController {
             ...(this.#projectIntentReminder
                 ? { projectIntentReminder: this.#projectIntentReminder }
                 : {}),
+            ...(this.#projectInventory ? { projectInventory: this.#projectInventory } : {}),
+            projectInventoryRefresh: this.#projectInventoryRefresh,
             ...(this.#status?.projectIntent?.state === 'absent' ? { projectDeclarationAbsent: true } : {}),
             ...(this.#status?.projectIntent?.state === 'invalid'
                 || this.#status?.projectIntent?.state === 'unavailable'
@@ -1197,13 +1207,34 @@ export class TuiController {
             portablePluginIds: this.#status.portablePluginIds,
             configStoreInventory: this.#status.configStoreInventory,
         });
+        this.#projectInventory = buildProjectInventory({
+            projectRoot: this.#status.projectRoot,
+            projectIntent: this.#status.projectIntent,
+            status: this.#status.payload,
+            pluginSummaries: this.#viewModel.plugins,
+            targetRevisions: this.#status.targetRevisions,
+            dependencyOverviews: this.#status.dependencyOverviews,
+            actionableTargets: this.#projectIntentReminder?.actionableTargets,
+        });
     }
     #normalizeRoute(route) {
-        return normalizeTuiRoute(route, this.#routeEntityState());
+        const state = this.#routeEntityState();
+        if (route.name === 'pluginDetail' || route.name === 'pluginPreview'
+            || route.name === 'pluginDependencies' && route.view !== 'removeBlocked'
+            || route.name === 'pluginDependencyNode') {
+            return normalizeTuiRoute(route, {
+                ...state,
+                hasPlugin: (pluginId) => this.getPluginDetailSubject(pluginId) !== undefined,
+            });
+        }
+        return normalizeTuiRoute(route, state);
     }
     #routeEntityState() {
         return {
-            hasPlugin: (pluginId) => this.#viewModel?.plugins.some((plugin) => plugin.pluginId === pluginId) ?? false,
+            hasPlugin: (pluginId) => this.#viewModel?.plugins.some((plugin) => plugin.pluginId === pluginId)
+                || this.#projectInventory?.declaredRoots.some((root) => root.pluginId === pluginId)
+                || this.#projectInventory?.extraInstalledRoots.some((root) => root.pluginId === pluginId)
+                || false,
             hasSource: (sourceId) => this.#viewModel?.sourceTabs.some((source) => source.id === sourceId) ?? false,
             hasIssue: (issueId) => this.#viewModel?.issues.some((issue) => issue.issueId === issueId) ?? false,
             hasHistoryRecord: (recordId) => this.#operationHistory.get(recordId) !== undefined,
@@ -1527,6 +1558,8 @@ export class TuiController {
         this.#assertAcceptingActions();
         this.dependencies.beginCatalogSession?.();
         const generation = ++this.#generation;
+        this.#projectInventoryRefreshToken += 1;
+        this.#projectInventoryRefresh = { state: 'idle' };
         this.#pluginContentEpoch += 1;
         this.#pluginContent.clear();
         this.#pluginContentInflight.clear();
@@ -1554,6 +1587,49 @@ export class TuiController {
         this.#loadError = undefined;
         this.#publish();
     }
+    listProjectInventoryRoots(section = 'declared') {
+        return cloneFrozen(section === 'declared'
+            ? this.#projectInventory?.declaredRoots ?? []
+            : this.#projectInventory?.extraInstalledRoots ?? []);
+    }
+    getProjectInventoryRoot(pluginId) {
+        const root = [...(this.#projectInventory?.declaredRoots ?? []),
+            ...(this.#projectInventory?.extraInstalledRoots ?? [])]
+            .find((entry) => entry.pluginId === pluginId);
+        return root ? cloneFrozen(root) : undefined;
+    }
+    async refreshProjectInventory() {
+        this.#assertAcceptingActions();
+        if (!this.#status || this.#phase !== 'ready')
+            return false;
+        const token = ++this.#projectInventoryRefreshToken;
+        const generation = this.#generation;
+        this.#projectInventoryRefresh = { state: 'checking' };
+        this.#publish();
+        try {
+            const status = await this.#trackRead(this.dependencies.loadStatus(this.#abort.signal));
+            if (this.#disposed || generation !== this.#generation
+                || token !== this.#projectInventoryRefreshToken)
+                return false;
+            this.#applyStatus(status);
+            this.#projectInventoryRefresh = {
+                state: 'idle',
+                checkedAtMs: this.#statusReadAtMs,
+            };
+            this.#publish();
+            return true;
+        }
+        catch (error) {
+            if (this.#disposed || generation !== this.#generation
+                || token !== this.#projectInventoryRefreshToken)
+                return false;
+            const code = issueCode(error);
+            await this.#logErrorSafe(error, code);
+            this.#projectInventoryRefresh = { state: 'error', errorCode: code };
+            this.#publish();
+            return false;
+        }
+    }
     push(route, context) {
         if (this.#router.snapshot.current.route.name === 'result') {
             this.#invalidatePortableResultRecheck();
@@ -2433,10 +2509,39 @@ export class TuiController {
     }
     listPlugins(options) {
         const query = options.query?.trim().toLocaleLowerCase('en');
+        const actualScopes = new Map();
+        const statusTargets = flattenStatusTargets(this.#status?.payload.targets ?? []);
+        const targetsByPlugin = new Map();
+        for (const target of statusTargets) {
+            targetsByPlugin.set(target.pluginId, [...(targetsByPlugin.get(target.pluginId) ?? []), target]);
+            const owned = target.platform === 'claude'
+                ? ['present', 'partial'].includes(statusTargetOwnershipState(target))
+                : target.components.some((component) => component.kind === 'ownership'
+                    && component.key !== 'native'
+                    && !component.key.startsWith('activation-')
+                    && !component.key.startsWith('marketplace-')
+                    && (component.state === 'present' || component.state === 'partial'));
+            const activation = target.platform === 'codex' ? statusTargetActivation(target) : undefined;
+            if (!owned && !(activation?.evidence === 'observed'
+                && activation[target.scope] === true)
+                && !hasStatusInstallationEvidence(target))
+                continue;
+            const scopes = actualScopes.get(target.pluginId) ?? new Set();
+            scopes.add(target.scope);
+            actualScopes.set(target.pluginId, scopes);
+        }
         return cloneFrozen((this.#viewModel?.plugins ?? []).filter((plugin) => (!options.sourceId || plugin.sourceId === options.sourceId)
             && (options.installFilter !== 'installed'
-                || hasInstalledPlacement(plugin))
-            && (options.installFilter !== 'uninstalled' || !hasInstalledPlacement(plugin))
+                || (actualScopes.get(plugin.pluginId)?.size ?? 0) > 0)
+            && (options.installFilter !== 'uninstalled'
+                || plugin.aggregateStatus === 'available'
+                    && (targetsByPlugin.get(plugin.pluginId)?.length ?? 0) > 0
+                    && targetsByPlugin.get(plugin.pluginId).every((target) => target.state === 'absent')
+                    && (actualScopes.get(plugin.pluginId)?.size ?? 0) === 0)
+            && (options.installFilter !== 'project'
+                || actualScopes.get(plugin.pluginId)?.has('project') === true)
+            && (options.installFilter !== 'user'
+                || actualScopes.get(plugin.pluginId)?.has('user') === true)
             && (options.installFilter !== 'updateAvailable' || plugin.update?.state === 'available')
             && (options.installFilter !== 'attention'
                 || plugin.aggregateStatus === 'needsAttention' || plugin.aggregateStatus === 'unavailable'
@@ -2448,6 +2553,20 @@ export class TuiController {
         const plugin = this.#viewModel?.plugins.find((entry) => entry.pluginId === pluginId);
         return plugin ? cloneFrozen(plugin) : undefined;
     }
+    getPluginDetailSubject(pluginId) {
+        if (!this.#status || !this.#viewModel)
+            return undefined;
+        const subject = buildPluginDetailSubject({
+            pluginId,
+            status: this.#status.payload,
+            pluginSummaries: this.#status.pluginSummaries,
+            targetRevisions: this.#status.targetRevisions,
+            plugins: this.#viewModel.plugins,
+            projectInventory: this.#projectInventory,
+            dependencyOverviews: this.#status.dependencyOverviews,
+        });
+        return subject ? cloneFrozen(subject) : undefined;
+    }
     getPluginContentOverview(pluginId) {
         const overview = this.#viewModel?.contentOverviews[pluginId];
         return overview ? cloneFrozen(overview) : undefined;
@@ -2485,6 +2604,10 @@ export class TuiController {
                 pluginVersion: '待确认',
                 catalogVersion: '待确认',
                 evidence: 'unavailable',
+                coverage: 'unavailable',
+                coverageIssue: {
+                    code: 'unreadable', message: '当前无法安全读取这个插件的内容。',
+                },
                 items: [],
                 notices: ['当前无法安全读取这个插件的内容。'],
             });
@@ -2511,7 +2634,20 @@ export class TuiController {
             }))].sort((left, right) => left.localeCompare(right, 'en')));
     }
     listPluginWriteBatchTargets(action, pluginIds) {
-        return cloneFrozen(pluginWriteBatchTargets(action, pluginIds, flattenStatusTargets(this.#status?.payload.targets ?? [])));
+        const targets = pluginWriteBatchTargets(action, pluginIds, flattenStatusTargets(this.#status?.payload.targets ?? []));
+        if (action === 'cleanup') {
+            for (const plugin of this.#viewModel?.plugins ?? []) {
+                if (!pluginIds.includes(plugin.pluginId) || !plugin.configOnly
+                    || targets.some((target) => target.pluginId === plugin.pluginId))
+                    continue;
+                targets.push({
+                    pluginId: plugin.pluginId,
+                    platform: 'codex',
+                    scope: plugin.savedConfigScopes[0] ?? 'user',
+                });
+            }
+        }
+        return cloneFrozen(targets);
     }
     listPluginInstallBatchTargets(pluginIds, platform, scope) {
         const platforms = platform === 'both' ? ['codex', 'claude'] : [platform];
@@ -2529,14 +2665,14 @@ export class TuiController {
                             && activation[scope] === true);
                 });
                 const exactOwnership = exactTarget ? statusTargetOwnershipState(exactTarget) : 'absent';
+                if (plugin?.catalogEntryMissing) {
+                    return { ...target, state: 'blocked', reason: '来源中没有可信插件定义' };
+                }
                 if (alreadyConfigured || exactOwnership === 'present' || exactOwnership === 'partial') {
                     return { ...target, state: 'existing' };
                 }
                 if (!plugin)
                     return { ...target, state: 'blocked', reason: '插件已不在当前状态中' };
-                if (plugin.configOnly) {
-                    return { ...target, state: 'blocked', reason: '来源中没有可信插件定义' };
-                }
                 if (plugin.sourceUnavailable) {
                     return { ...target, state: 'blocked', reason: '插件来源不可用' };
                 }
@@ -2617,6 +2753,11 @@ export class TuiController {
         const plugin = this.#viewModel?.plugins.find((entry) => entry.pluginId === pluginId);
         if (!plugin)
             return [];
+        if (plugin.catalogEntryMissing) {
+            return plugin.supportedPlatforms.map((platform) => ({
+                platform, compatible: false, disabled: '来源中没有可信插件定义',
+            }));
+        }
         if (plugin.aggregateStatus === 'unavailable') {
             return plugin.supportedPlatforms.map((platform) => ({
                 platform,
@@ -3277,6 +3418,20 @@ export class TuiController {
             assertPluginWriteTaskEvidence(intent, evidence);
         if (this.#router.snapshot.current.route.name === 'result')
             navigation = 'replace';
+        const configEvidence = intent.kind === 'configSave'
+            ? evidence.config ? [evidence.config] : undefined
+            : intent.kind === 'configSaveBatch'
+                ? evidence.configBatch?.groups.map((group) => group.config)
+                : undefined;
+        if ((intent.kind === 'configSave' || intent.kind === 'configSaveBatch')
+            && (!configEvidence || configEvidence.length !== (intent.kind === 'configSave' ? 1 : intent.groups.length))) {
+            throw new TuiOperationBlockedError('configImpactUnavailable', '设置确认缺少完整的应用影响证据。');
+        }
+        const configImpact = configEvidence ? {
+            state: configEvidence.some((group) => group.impactState !== 'known') ? 'unknown' : 'known',
+            affectedTargetCount: new Set(configEvidence.flatMap((group) => group.affectedTargets
+                .map((target) => `${target.platform}\0${target.scope}`))).size,
+        } : undefined;
         const projection = buildOperationReviewProjection({
             intent,
             evidence,
@@ -3349,6 +3504,7 @@ export class TuiController {
                 ? { originIssue: intent.originIssue }
                 : {}),
             ...projection,
+            ...(configImpact ? { configImpact } : {}),
             subject: {
                 name: 'pluginId' in intent
                     ? this.#viewModel?.plugins.find((plugin) => plugin.pluginId === intent.pluginId)?.displayName