@lesliechan721/aw 0.1.0-beta.3 → 0.1.0-beta.30

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

@@ -1,7 +1,14 @@
-import type { PlatformName, PluginConfigFieldType, PluginConfigPresentationPreset, PluginConfigSchema, Scope } from '../types.js';
-import type { StatusV4Payload, StatusV4PluginSummary, StatusV4Target, StatusV4Component } from '../commands/status-v4.js';
+import type { PlatformName, PluginConfigFieldType, PluginConfigPreset, PluginConfigSchemaField, 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 } 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 +19,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 +94,63 @@ 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;
     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 +184,7 @@ export interface PluginDependencyItemViewModel {
     placements: PlatformPlacementSummary[];
     aggregateStatus: 'ready' | 'notInstalled' | 'needsAttention' | 'unavailable';
     placementReferences?: DependencyPlacementReferenceViewModel[];
+    availablePlacementReferences?: DependencyPlacementReferenceViewModel[];
 }
 export interface PluginDependencyBlockerViewModel {
     code: string;
@@ -92,28 +198,59 @@ 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;
+    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 +258,54 @@ 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;
     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 +314,26 @@ 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 ConfigPageViewModel {
     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 declare function configObjectHasSensitiveChild(field: PluginConfigSchemaField): boolean;
+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 +342,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 +375,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,6 +403,7 @@ export interface TuiViewModel {
     issues: UserIssueViewModel[];
     home: HomeSummaryViewModel;
     dependencyOverviews: PluginDependencyOverviewViewModel[];
+    contentOverviews: Record<string, PluginContentOverview>;
 }
 export interface PortableSkillCandidateViewModel {
     name: string;
@@ -257,23 +435,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;