@lesliechan721/aw 0.1.0-beta.4 → 0.1.0-beta.41

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

@@ -9,4 +9,48 @@ export interface TuiKeyInput {
     input: string;
     key: Pick<Key, 'ctrl' | 'escape'>;
 }
+export type TuiSessionNavigationKeyAction = 'home' | 'reload';
+export type TuiGlobalKeyAction = TuiSessionNavigationKeyAction | 'back' | 'help' | 'exit' | 'cancel';
+export interface TuiGlobalActionDefinition {
+    action: TuiGlobalKeyAction;
+    key: 'h' | 'H' | 'Escape' | 'b' | '?' | 'q' | 'Ctrl+C';
+    menuOnly: boolean;
+}
+export declare const TUI_GLOBAL_ACTIONS: readonly [{
+    readonly action: "home";
+    readonly key: "h";
+    readonly menuOnly: true;
+}, {
+    readonly action: "reload";
+    readonly key: "H";
+    readonly menuOnly: true;
+}, {
+    readonly action: "back";
+    readonly key: "b";
+    readonly menuOnly: true;
+}, {
+    readonly action: "back";
+    readonly key: "Escape";
+    readonly menuOnly: true;
+}, {
+    readonly action: "help";
+    readonly key: "?";
+    readonly menuOnly: true;
+}, {
+    readonly action: "exit";
+    readonly key: "q";
+    readonly menuOnly: true;
+}, {
+    readonly action: "cancel";
+    readonly key: "Escape";
+    readonly menuOnly: false;
+}, {
+    readonly action: "exit";
+    readonly key: "Ctrl+C";
+    readonly menuOnly: false;
+}];
+export declare function resolveTuiGlobalKeyAction(event: TuiKeyInput, context: TuiKeyContext): TuiGlobalKeyAction | null;
+export declare function resolveTuiSessionNavigationKey(event: TuiKeyInput, options: {
+    characterInput: boolean;
+}): TuiSessionNavigationKeyAction | null;
 export declare function resolveTuiKeyAction(event: TuiKeyInput, context: TuiKeyContext): Exclude<CliPromptAction, 'select'> | null;

package/dist/src/tui/keys.js

@@ -1,22 +1,50 @@
-export function resolveTuiKeyAction(event, context) {
-    if (event.key.ctrl && event.input.toLowerCase() === 'c') {
-        return 'exit';
-    }
+export const TUI_GLOBAL_ACTIONS = [
+    { action: 'home', key: 'h', menuOnly: true },
+    { action: 'reload', key: 'H', menuOnly: true },
+    { action: 'back', key: 'b', menuOnly: true },
+    { action: 'back', key: 'Escape', menuOnly: true },
+    { action: 'help', key: '?', menuOnly: true },
+    { action: 'exit', key: 'q', menuOnly: true },
+    { action: 'cancel', key: 'Escape', menuOnly: false },
+    { action: 'exit', key: 'Ctrl+C', menuOnly: false },
+];
+function registeredAction(action, key) {
+    return TUI_GLOBAL_ACTIONS.find((definition) => definition.action === action && definition.key === key).action;
+}
+export function resolveTuiGlobalKeyAction(event, context) {
+    if (event.key.ctrl && event.input.toLowerCase() === 'c')
+        return registeredAction('exit', 'Ctrl+C');
     if (event.key.escape) {
-        if (context.mode === 'menu') {
-            return context.allowBack ? 'back' : 'exit';
-        }
-        return 'cancel';
+        return context.mode === 'menu' && context.allowBack
+            ? registeredAction('back', 'Escape')
+            : registeredAction('cancel', 'Escape');
     }
-    if (context.mode !== 'menu') {
+    if (context.mode !== 'menu' || event.key.ctrl)
         return null;
-    }
-    if (context.allowBack && event.input.toLowerCase() === 'b') {
-        return 'back';
-    }
-    if (event.input.toLowerCase() === 'q') {
+    if (event.input === 'H')
+        return registeredAction('reload', 'H');
+    if (event.input === 'h')
+        return registeredAction('home', 'h');
+    if (context.allowBack && event.input.toLowerCase() === 'b')
+        return registeredAction('back', 'b');
+    if (event.input === '?')
+        return registeredAction('help', '?');
+    if (event.input.toLowerCase() === 'q')
+        return registeredAction('exit', 'q');
+    return null;
+}
+export function resolveTuiSessionNavigationKey(event, options) {
+    const action = resolveTuiGlobalKeyAction(event, {
+        mode: options.characterInput ? 'text' : 'menu',
+    });
+    return action === 'home' || action === 'reload' ? action : null;
+}
+export function resolveTuiKeyAction(event, context) {
+    const action = resolveTuiGlobalKeyAction(event, context);
+    if (action === 'cancel' && context.mode === 'menu')
         return 'exit';
-    }
+    if (action === 'back' || action === 'exit' || action === 'cancel')
+        return action;
     return null;
 }
 //# sourceMappingURL=keys.js.map

package/dist/src/tui/keys.js.map

@@ -1 +1 @@
-{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/tui/keys.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,mBAAmB,CACjC,KAAkB,EAClB,OAAsB;IAEtB,IAAI,KAAK,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;QACxD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAI,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACrB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC5B,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7C,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,OAAO,CAAC,SAAS,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;QAC3D,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,GAAG,EAAE,CAAC;QACtC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}
+{"version":3,"file":"keys.js","sourceRoot":"","sources":["../../../src/tui/keys.ts"],"names":[],"mappings":"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"}

package/dist/src/tui/lifecycle-action-view.d.ts

@@ -0,0 +1,6 @@
+import type { AllowedLifecycleAction } from '../commands/operation-planner.js';
+export interface LifecycleActionViewModel {
+    label: string;
+    description: string;
+}
+export declare function projectLifecycleActionView(action: AllowedLifecycleAction): LifecycleActionViewModel;

package/dist/src/tui/lifecycle-action-view.js

@@ -0,0 +1,36 @@
+export function projectLifecycleActionView(action) {
+    if (action.id === 'install')
+        return {
+            label: '添加插件',
+            description: '添加所选平台和使用位置。',
+        };
+    if (action.id === 'sync')
+        return {
+            label: '同步已保存使用设置',
+            description: '按已保存使用设置修复当前使用位置。',
+        };
+    if (action.id === 'refreshAndSync')
+        return {
+            label: action.availableVersion ? `更新到 ${action.availableVersion}` : '刷新并同步',
+            description: action.availableVersion
+                ? `使用当前启用目录中已确认的 ${action.availableVersion} 同步。`
+                : '刷新相关来源后，使用新的当前启用版本同步。',
+        };
+    if (action.id === 'reinstall')
+        return {
+            label: '重新安装',
+            description: '保留设置并重新生成 AW 管理内容。',
+        };
+    if (action.id === 'cleanup')
+        return {
+            label: '清理 AW 管理内容',
+            description: action.reason === 'orphanedManagedContent'
+                ? '只清理这个插件目标的 AW 管理内容。'
+                : '只清理可证明属于 AW 的内容。',
+        };
+    return {
+        label: '移除插件',
+        description: '移除 AW 管理的安装内容并保留设置。',
+    };
+}
+//# sourceMappingURL=lifecycle-action-view.js.map

package/dist/src/tui/lifecycle-action-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle-action-view.js","sourceRoot":"","sources":["../../../src/tui/lifecycle-action-view.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,0BAA0B,CACxC,MAA8B;IAE9B,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO;YAClC,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,cAAc;SAC5B,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,MAAM;QAAE,OAAO;YAC/B,KAAK,EAAE,WAAW;YAClB,WAAW,EAAE,mBAAmB;SACjC,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,gBAAgB;QAAE,OAAO;YACzC,KAAK,EAAE,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,OAAO;YAC3E,WAAW,EAAE,MAAM,CAAC,gBAAgB;gBAClC,CAAC,CAAC,iBAAiB,MAAM,CAAC,gBAAgB,MAAM;gBAChD,CAAC,CAAC,uBAAuB;SAC5B,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,WAAW;QAAE,OAAO;YACpC,KAAK,EAAE,MAAM;YACb,WAAW,EAAE,oBAAoB;SAClC,CAAC;IACF,IAAI,MAAM,CAAC,EAAE,KAAK,SAAS;QAAE,OAAO;YAClC,KAAK,EAAE,YAAY;YACnB,WAAW,EAAE,MAAM,CAAC,MAAM,KAAK,wBAAwB;gBACrD,CAAC,CAAC,qBAAqB;gBACvB,CAAC,CAAC,kBAAkB;SACvB,CAAC;IACF,OAAO;QACL,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,qBAAqB;KACnC,CAAC;AACJ,CAAC"}

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

@@ -1,7 +1,15 @@
-import type { PlatformName, PluginConfigFieldType, PluginConfigPresentationPreset, PluginConfigSchema, Scope } from '../types.js';
-import type { StatusV4Payload, StatusV4PluginSummary, StatusV4Target, StatusV4Component } from '../commands/status-v4.js';
+export { configObjectHasSensitiveChild } from './config-value-presentation.js';
+import type { PlatformName, PluginConfigFieldType, PluginConfigPreset, PluginConfigSchemaField, PluginConfigJoinSummary, PluginConfigSchema, PluginConfigValue, Scope } from '../types.js';
+import type { StatusActivationProjection, StatusExtensionProjection, StatusIntentProjection, StatusSharedNativeProjection, StatusV8Payload, StatusV8PluginSummary, StatusScopedTarget, StatusV8Component, StatusTargetRevision, TargetRevisionState } from '../commands/status-v6.js';
+import type { PluginContentOverview } from './plugin-content.js';
+import type { DependencyAssignmentSource, DependencyPlacementRootInput } from '../commands/dependency-operation-plan.js';
+import type { ReconcileOperationPlan } from '../commands/reconcile-operation-plan.js';
+import type { DependencyScopeOverride } from '../types.js';
 import type { ResolvedConfigRead } from '../utils/plugin-config.js';
-export type SourceHealthState = 'ready' | 'cache' | 'path' | 'checking' | 'degraded' | 'unavailable';
+import { type DiagnosticSummaryViewModel } from './diagnostics.js';
+import type { CatalogSourceFreshnessViewModel } from './catalog-freshness.js';
+import type { CatalogSourceGenerationViewModel } from './catalog-generation.js';
+export type SourceHealthState = 'ready' | 'unavailable';
 export interface SourceHealthViewModel {
     sourceId: string;
     state: SourceHealthState;
@@ -12,19 +20,72 @@ export type PlatformPlacementSummary = {
     platform: PlatformName;
     state: 'notInstalled';
     supportedScopes: Scope[];
+} | {
+    platform: PlatformName;
+    state: 'blocked';
+    supportedScopes: Scope[];
+    reason: 'artifactCollision';
 } | {
     platform: PlatformName;
     state: 'installed';
     scope: Scope;
     health: 'ready' | 'incomplete' | 'error';
+    revision: TargetRevisionState;
+    desiredScopes?: Scope[];
+    actualScopes?: Scope[];
+    relation?: StatusIntentProjection['relation'];
+    actualState?: StatusScopedTarget['state'];
+    activation?: StatusActivationProjection;
+    sharedNative?: StatusSharedNativeProjection;
+    extensions?: StatusExtensionProjection;
+    recovery?: StatusScopedTarget['recoveryActions'];
+    blockingReason?: 'artifactCollision';
+    scopedPlacements?: Array<{
+        scope: Scope;
+        health: 'ready' | 'incomplete' | 'error';
+        revision: TargetRevisionState;
+        actualState?: StatusScopedTarget['state'];
+        recovery?: StatusScopedTarget['recoveryActions'];
+        blockingReason?: 'artifactCollision';
+    }>;
 } | {
     platform: PlatformName;
     state: 'scopeConflict';
     placements: Array<{
         scope: Scope;
         health: 'ready' | 'incomplete' | 'error';
+        revision: TargetRevisionState;
     }>;
 };
+export type PluginMenuAction = {
+    id: 'add' | 'manage' | 'repair' | 'portableSkills' | 'dependencies' | 'settings' | 'source' | 'sourceProblem' | 'about' | 'refreshSource' | 'technical' | 'back' | 'outputCollision' | 'upgradeAwCli' | 'capabilityTechnical';
+} | {
+    id: 'addScope';
+    platform: PlatformName;
+    scope: Scope;
+} | {
+    id: 'resolveScopeConflict';
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+    keepScope: Scope;
+    description: string;
+} | {
+    id: 'platform' | 'scopeConflict';
+    platform: PlatformName;
+} | {
+    id: 'refreshAndSync';
+    platform: PlatformName;
+    scope: Scope;
+    availableVersion: string;
+    installedVersion: string;
+    sourceIdentity: string;
+    generationKey: string;
+} | {
+    id: 'sync' | 'reinstall' | 'remove' | 'cleanup';
+    platform: PlatformName;
+    scope: Scope;
+};
 export interface PluginListItemViewModel {
     pluginId: string;
     sourceId: string;
@@ -34,18 +95,65 @@ export interface PluginListItemViewModel {
     configFieldCount: number;
     sourceLabel: string;
     supportedPlatforms: PlatformName[];
+    supportedScopes?: Partial<Record<PlatformName, Scope[]>>;
     installedPlacements: PlatformPlacementSummary[];
     aggregateStatus: 'available' | 'installed' | 'needsAttention' | 'unavailable';
+    primaryAttention?: {
+        severity: 'warning' | 'error';
+        code: string;
+        message: string;
+    };
     portableSkills: boolean;
+    missingCapabilities?: string[];
+    capabilityUnsupported?: boolean;
+    capabilityRecovery?: string;
+    sourceUnavailable?: boolean;
+    savedConfigScopes: Scope[];
+    configOnly?: true;
+    catalogEntryMissing?: true;
+    removedPluginCleanupRequired?: true;
     dependencySummary?: PluginDependencySummaryViewModel;
     technicalComponents: Array<{
         platform: PlatformName;
-        scope: Scope;
+        scope?: Scope;
+        shared?: true;
         key: string;
-        state: StatusV4Component['state'];
+        state: StatusV8Component['state'];
         errorCode?: string;
     }>;
+    update: PluginUpdateSummary;
+}
+export type PluginUpdateState = 'notChecked' | 'currentAgainstCatalog' | 'available' | 'sourceChangedUnverified' | 'blocked' | 'unknown';
+export interface PluginUpdateTargetSummary {
+    platform: PlatformName;
+    scope: Scope;
+    installedVersion?: string;
+    activeVersion?: string;
+    candidateVersion?: string;
+    availableVersion?: string;
+    candidateEvidence?: string;
+    missingCapabilities?: string[];
+    eligibility: 'allowed' | 'needsRepair' | 'incompatible' | 'unverified';
+    requiresCatalogActivation?: true;
 }
+export interface PluginUpdateSummary {
+    pluginId: string;
+    state: PluginUpdateState;
+    checkedAt?: string;
+    lastSuccessful?: true;
+    sourceIdentity?: string;
+    generationKey?: string;
+    targets: PluginUpdateTargetSummary[];
+}
+export declare function buildPluginUpdateSummary(options: {
+    pluginId: string;
+    sourceId: string;
+    targetRevisions: StatusTargetRevision[];
+    targets: StatusScopedTarget[];
+    freshness?: CatalogSourceFreshnessViewModel;
+    sourceIdentity?: string;
+    generationKey?: string;
+}): PluginUpdateSummary;
 export interface PluginDependencySummaryViewModel {
     directCount: number;
     transitiveCount: number;
@@ -79,6 +187,7 @@ export interface PluginDependencyItemViewModel {
     placements: PlatformPlacementSummary[];
     aggregateStatus: 'ready' | 'notInstalled' | 'needsAttention' | 'unavailable';
     placementReferences?: DependencyPlacementReferenceViewModel[];
+    availablePlacementReferences?: DependencyPlacementReferenceViewModel[];
 }
 export interface PluginDependencyBlockerViewModel {
     code: string;
@@ -92,28 +201,60 @@ export interface PluginDependencyOverviewViewModel {
     dependents: PluginDependencyItemViewModel[];
     blockers: PluginDependencyBlockerViewModel[];
 }
+export interface DependencyPlacementTargetViewModel {
+    key: string;
+    pluginId: string;
+    displayName: string;
+    platform: PlatformName;
+    relation: 'direct' | 'transitive';
+    scope: Scope;
+    minimumScope: Scope;
+    allowedScopes: Scope[];
+    locked: boolean;
+    requiredBy: string[];
+    assignmentSource: DependencyAssignmentSource;
+    explanation: string;
+    affectsOtherProjects: boolean;
+    action: ReconcileOperationPlan['targets'][number]['action'];
+}
+export interface InstallPlacementDraftViewModel {
+    pluginId: string;
+    rootScope: Scope;
+    exactRootTargets?: DependencyPlacementRootInput[];
+    platforms: PlatformName[];
+    dependencyScopeOverrides: DependencyScopeOverride[];
+    state: 'selecting' | 'loading' | 'ready' | 'blocked';
+    targets: DependencyPlacementTargetViewModel[];
+    canContinue: boolean;
+    error?: {
+        code: string;
+        message: string;
+    };
+}
 export interface SourceTabViewModel {
     id: string;
     label: string;
     count?: number;
     primary: boolean;
-    state: 'ready' | 'cache' | 'path' | 'error';
+    state: 'ready' | 'checking' | 'update' | 'recovery' | 'error';
 }
 export interface SourceDetailViewModel {
     id: string;
     type: 'git' | 'path';
     primary: boolean;
+    autoCheck: boolean;
     locationSummary: string;
     refPolicy?: 'cliChannel' | 'explicit';
     explicitRef?: string;
     subdir?: string;
-    pluginCount: number;
+    pluginCount?: number;
     sourceIdentity: string;
     requestedRef: string;
     resolvedCommit?: string;
     catalogVersion?: string;
     channel?: string;
-    freshness?: 'remote' | 'cache' | 'path';
+    freshness?: 'active';
+    errorCode?: string;
     configDigest: string;
 }
 export interface HomeSummaryViewModel {
@@ -121,31 +262,56 @@ export interface HomeSummaryViewModel {
     installedPlugins: number;
     issueCount: number;
     sourceCount: number;
-    cachedSourceCount: number;
     unavailableSourceCount: number;
+    catalogUpdateCount: number;
+    catalogRecoveryCount: number;
+    catalogCheckingCount: number;
+    pluginUpdateCount: number;
+    directPluginUpdateCount: number;
 }
 export interface ConfigFieldViewModel {
     key: string;
     title: string;
     description?: string;
     type: PluginConfigFieldType;
+    definition: PluginConfigSchemaField;
+    summary?: PluginConfigJoinSummary;
+    itemSummary?: PluginConfigJoinSummary;
     displayValue: string;
     required: boolean;
     sensitive: boolean;
+    writable: boolean;
+    canSet: boolean;
+    canUnset: boolean;
     dirty: boolean;
     inherited: boolean;
     configured: boolean;
     sourceLabel: string;
-    value?: string | number | boolean;
-    defaultValue?: string | number | boolean;
-    enumValues?: string[];
-    valueLabels?: Record<string, string>;
-    recommendedValue?: string | number | boolean;
+    effectiveDisplayValue: string;
+    effectiveSourceLabel: string;
+    fallbackDisplayValue?: string;
+    fallbackSourceLabel?: string;
+    invalidOverrideIssue?: string;
+    invalidOverrideOwnedByLayer?: boolean;
+    fallbackObjectChanges?: Array<{
+        property: string;
+        before: string;
+        after: string;
+        private?: boolean;
+    }>;
+    value?: PluginConfigValue;
+    effectiveValue?: PluginConfigValue;
+    draftValue?: PluginConfigValue;
+    defaultValue?: PluginConfigValue;
+    choices?: PluginConfigPreset[];
+    allowCustom: boolean;
+    matchedPresetId?: string;
     placeholder?: string;
     unit?: string;
     min?: number;
     max?: number;
     advanced: boolean;
+    sharedNativeRender?: boolean;
 }
 export interface ConfigGroupViewModel {
     id: string;
@@ -154,22 +320,31 @@ export interface ConfigGroupViewModel {
     advanced: boolean;
     fields: ConfigFieldViewModel[];
 }
-export interface ConfigPresetViewModel extends Omit<PluginConfigPresentationPreset, 'values'> {
-    values: Record<string, string | number | boolean>;
+export interface ConfigPresetViewModel {
+    id: string;
+    title: string;
+    description?: string;
+    values: Record<string, PluginConfigValue>;
     privateFieldTitles?: string[];
 }
+export interface ConfigEditEvidence {
+    sourceIdentity: string;
+    schemaIdentity: string;
+    storeDigests: Partial<Record<Scope, string>>;
+}
 export interface ConfigPageViewModel {
+    editEvidence?: ConfigEditEvidence;
     pluginId: string;
     layer: {
         scope: Scope | 'effective';
-        projectLayer: 'shared' | 'local';
     };
     groups: ConfigGroupViewModel[];
     presets: ConfigPresetViewModel[];
     storedCount: number;
 }
-export type UserIssueCategory = 'incompleteInstallation' | 'sourceDegraded' | 'sourceUnavailable' | 'sourceMissing' | 'sourceIdentityChanged' | 'requiredConfigMissing' | 'scopeConflict' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'legacyState' | 'diagnostic';
-export type UserIssueActionId = 'reinstall' | 'remove' | 'refreshSource' | 'continueWithCache' | 'editSource' | 'retryLater' | 'reAddSource' | 'viewSourceChange' | 'openConfig' | 'keepUserScope' | 'keepProjectScope' | 'viewTechnical' | 'manualMigration' | 'installDependency' | 'reinstallDependency' | 'viewDependencyIssue' | 'viewDependencies';
+export type UserIssueCategory = 'incompleteInstallation' | 'artifactCollision' | 'sourceUnavailable' | 'sourceMissing' | 'sourceIdentityChanged' | 'requiredConfigMissing' | 'configLayerUnsupported' | 'scopeConflict' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'legacyState' | 'diagnostic';
+export type UserIssueGroup = 'sourceRemoved' | 'artifactCollision' | 'sourceUnavailable' | 'dependency' | 'scope' | 'config' | 'installation' | 'diagnostic';
+export type UserIssueActionId = 'install' | 'sync' | 'refreshAndSync' | 'reinstall' | 'cleanup' | 'remove' | 'refreshSource' | 'editSource' | 'retryLater' | 'reAddSource' | 'viewSourceChange' | 'openConfig' | 'keepUserScope' | 'keepProjectScope' | 'viewTechnical' | 'manualMigration' | 'installDependency' | 'reinstallDependency' | 'viewDependencyIssue' | 'viewDependencies';
 export interface UserIssueActionViewModel {
     id: UserIssueActionId;
     label: string;
@@ -178,12 +353,21 @@ export interface UserIssueActionViewModel {
     platform?: PlatformName;
     scope?: Scope;
     project?: 'current' | 'other' | null;
-    writeAction?: 'install' | 'upgrade' | 'reinstall';
+    writeAction?: 'install' | 'refreshAndSync' | 'reinstall' | 'uninstall' | 'cleanup' | 'sync';
+}
+export type TargetIssueRootCode = 'partial' | 'artifactCollision' | 'sourceMissing' | 'sourceChanged' | 'catalogSourceUnavailable' | 'bundleUnavailable' | 'codexIntentSourceUnavailable' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'targetDiagnostic';
+export interface TargetIssueEntityViewModel {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+}
+export interface AffectedTargetViewModel extends TargetIssueEntityViewModel {
+    relationship: 'direct' | 'consumer';
 }
-export type TargetIssueRootCode = 'partial' | 'sourceMissing' | 'sourceChanged' | 'catalogSourceUnavailable' | 'bundleUnavailable' | 'dependencyMissing' | 'dependencyNotReady' | 'dependencyTargetUnsupported' | 'dependencyStillRequired' | 'dependencyGraphInvalid' | 'targetDiagnostic';
 export interface UserIssueViewModel {
     issueId: string;
     category: UserIssueCategory;
+    group: UserIssueGroup;
     title: string;
     explanation: string;
     impact: string[];
@@ -202,22 +386,26 @@ export interface UserIssueViewModel {
     sourceIdentity?: string;
     rootCode?: TargetIssueRootCode;
     mergeEligible?: boolean;
+    relationship?: 'direct' | 'consumer';
+    rootEntity?: TargetIssueEntityViewModel;
+    affectedTargets?: AffectedTargetViewModel[];
     placements?: Scope[];
     requiredFields?: Array<{
         key: string;
         title: string;
-        type: 'missing-required' | 'invalid-config';
-        source: 'default' | 'user' | 'project' | 'projectLocal' | 'missing';
+        type: 'missing-required' | 'invalid-config' | 'sharedCompositeContainsLocalPath' | 'configLayerUnsupported';
+        source: 'default' | 'user' | 'project' | 'missing';
+        scope: Scope;
     }>;
     configLayer?: {
         scope: Scope;
-        projectLayer: 'shared' | 'local';
     };
     actions: UserIssueActionViewModel[];
     technicalDetails: Array<{
         code: string;
         message: string;
     }>;
+    diagnostic: DiagnosticSummaryViewModel;
 }
 export interface TuiViewModel {
     plugins: PluginListItemViewModel[];
@@ -226,10 +414,13 @@ export interface TuiViewModel {
     issues: UserIssueViewModel[];
     home: HomeSummaryViewModel;
     dependencyOverviews: PluginDependencyOverviewViewModel[];
+    contentOverviews: Record<string, PluginContentOverview>;
 }
 export interface PortableSkillCandidateViewModel {
     name: string;
     description: string;
+    shortDescription?: string;
+    shortDescriptionSource?: 'metadata' | 'fallback';
     selected: boolean;
     providerPluginId: string;
     providerDisplayName: string;
@@ -257,23 +448,53 @@ export interface PortableSkillSelectionViewModel {
     };
     canContinue: boolean;
 }
-export declare function projectPlatformPlacement(platform: PlatformName, targets: StatusV4Target[]): PlatformPlacementSummary;
+export declare function isDirectCodexVersionUpgrade(target: StatusScopedTarget, revision: TargetRevisionState): boolean;
+export declare function isPureNativeCodexTarget(target: StatusScopedTarget): boolean;
+export declare function hasActualScopeEvidence(target: StatusScopedTarget): boolean;
+export declare function dependencyPlacementTargets(plan: ReconcileOperationPlan): DependencyPlacementTargetViewModel[];
+export declare function projectPlatformPlacement(platform: PlatformName, targets: StatusScopedTarget[], revisions?: StatusTargetRevision[]): PlatformPlacementSummary;
+export declare function buildPluginPreviewActions(plugin: PluginListItemViewModel): PluginMenuAction[];
+export declare function buildPluginDetailActions(plugin: PluginListItemViewModel): PluginMenuAction[];
+export declare function buildPlatformActions(plugin: PluginListItemViewModel, platform: PlatformName): PluginMenuAction[];
 export declare function hasInstalledPlacement(plugin: PluginListItemViewModel): boolean;
 export declare function buildTuiViewModel(options: {
-    status: StatusV4Payload;
-    pluginSummaries: StatusV4PluginSummary[];
+    status: StatusV8Payload;
+    pluginSummaries: StatusV8PluginSummary[];
+    targetRevisions?: StatusTargetRevision[];
     sourceHealth?: ReadonlyMap<string, SourceHealthViewModel>;
     sourceDetails?: SourceDetailViewModel[];
+    catalogFreshness?: ReadonlyMap<string, CatalogSourceFreshnessViewModel>;
+    catalogGenerations?: ReadonlyMap<string, CatalogSourceGenerationViewModel>;
     dependencyOverviews?: PluginDependencyOverviewViewModel[];
+    contentOverviews?: Record<string, PluginContentOverview>;
     portablePluginIds?: string[];
+    configStoreInventory?: Array<{
+        pluginId: string;
+        sourceId: string;
+        pluginName: string;
+        scope: Scope;
+    }>;
 }): TuiViewModel;
 export declare function buildConfigGroups(options: {
     schema: PluginConfigSchema;
     read: ResolvedConfigRead;
+    effectiveRead?: ResolvedConfigRead;
+    layerReads?: Partial<Record<Scope, ResolvedConfigRead>>;
     dirtyKeys?: ReadonlySet<string>;
+    rawValues?: Record<string, PluginConfigValue>;
+    rawLayerValues?: Partial<Record<Scope, Record<string, PluginConfigValue>>>;
+    effectiveRawValues?: Record<string, PluginConfigValue>;
+    sharedNativeRefreshKeys?: ReadonlySet<string>;
 }): ConfigGroupViewModel[];
 export declare function buildConfigPage(options: {
     pluginId: string;
     schema: PluginConfigSchema;
     read: ResolvedConfigRead;
+    effectiveRead?: ResolvedConfigRead;
+    layerReads?: Partial<Record<Scope, ResolvedConfigRead>>;
+    rawValues?: Record<string, PluginConfigValue>;
+    rawLayerValues?: Partial<Record<Scope, Record<string, PluginConfigValue>>>;
+    effectiveRawValues?: Record<string, PluginConfigValue>;
+    sharedNativeRefreshKeys?: ReadonlySet<string>;
 }): ConfigPageViewModel;
+export declare function configValuesEqual(left: PluginConfigValue | undefined, right: PluginConfigValue | undefined): boolean;