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

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

@@ -1,20 +1,23 @@
 import type { CatalogActivationMode, CatalogSource, CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogGenerationSyncResult, CatalogSourceImpact, DependencyScopeOverride, PlatformName, Scope } from '../types.js';
-import type { PortableReview } from '../portable/commands.js';
+import type { PortableReview, PortableInstallReceipt, PortableRetryReview } from '../portable/commands.js';
 import type { CatalogSourceUpdate } from '../utils/catalog-sources.js';
 import type { CatalogGenerationFreshnessState, CatalogGenerationFreshnessResult } from '../utils/catalog-generation-service.js';
 import type { StatusV8Payload, StatusV8PluginSummary, StatusScopedTarget, StatusTargetRevision } from '../commands/status-v6.js';
 import type { ReconcileOperationPlan } from '../commands/reconcile-operation-plan.js';
-import type { RebuildCommandResult } from '../commands/rebuild-command.js';
+import type { PreApplyAuthorizationTarget, RebuildCommandResult } from '../commands/rebuild-command.js';
 import type { OfflineCleanupTargetEvidence } from '../commands/offline-cleanup-evidence.js';
 import type { CodexReconcilePlan } from '../utils/codex-reconciler.js';
 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 { OperationHistoryStore, type OperationDiagnosticDetail, type OperationEffectFacts, type OperationHistorySummary, type OperationReportPreview, type SafeOperationDiagnostic, type SaveOperationReportResult } from './operation-history.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';
 import type { CatalogSessionReusableCandidate } from './catalog-sources/types.js';
+import type { CatalogStoreStatusResult } from '../commands/catalog-store.js';
+import type { CatalogStoreTaskEvidence } from './catalog-store-task.js';
 import { type PluginWriteTaskBlockedTarget, type PluginWriteTaskCandidate, type PluginWriteTaskCause, type PluginWriteTaskGoal, type PluginWriteTaskIntent, type PluginWriteTaskTarget } from './plugin-write-task.js';
 export type { PluginWriteTaskBlockReason, PluginWriteTaskCandidate, PluginWriteTaskExpectedUpdate, PluginWriteTaskGoal, PluginWriteTaskIntent, PluginWriteTaskMethod, PluginWriteTaskTarget, } from './plugin-write-task.js';
 type CatalogActivationBlockReason = 'configDraft' | 'sourceDraft' | 'batchDraft' | 'portableDraft' | 'activeReview' | 'reviewPreparation' | 'writeProgress';
@@ -33,6 +36,9 @@ export type PluginWriteBatchSelection = {
 } | {
     kind: 'targets';
     targets: PluginWriteBatchTarget[];
+} | {
+    kind: 'currentProjectIntentTargets';
+    targets: PluginWriteBatchTarget[];
 } | {
     kind: 'currentProjectIntentRoots';
 };
@@ -66,6 +72,7 @@ export interface PluginWriteBatchGroupEvidence {
 export interface PluginWriteBatchEvidence extends OperationEvidence {
     requestedPluginIds: string[];
     groups: PluginWriteBatchGroupEvidence[];
+    projectIntentDigest?: string;
     targetVersions?: Array<PluginWriteBatchTarget & {
         presence: 'new' | 'installed' | 'unknown';
         installedVersion?: string;
@@ -115,6 +122,39 @@ export interface PluginWriteTaskExecutionResult extends RebuildCommandResult {
     sourceResults: PluginWriteTaskSourceResult[];
 }
 export type OperationKind = OperationIntent['kind'];
+export interface ConfigOperationChange {
+    key: string;
+    title: string;
+    before: string;
+    after: string;
+    children?: Array<{
+        property: string;
+        before: string;
+        after: string;
+        private?: boolean;
+    }>;
+}
+export interface ConfigSaveBatchGroup {
+    scope: Scope;
+    updates?: Record<string, unknown>;
+    removeKeys?: string[];
+    sensitiveKeys?: string[];
+    privateKeys?: string[];
+    changes?: ConfigOperationChange[];
+}
+export interface ConfigSaveBatchGroupResult {
+    scope: Scope;
+    status: 'succeeded' | 'failed';
+    configSaved: boolean;
+    applyRequested: boolean;
+    applyStatus: 'notRequested' | 'notNeeded' | 'succeeded' | 'failed';
+    errorCode?: string;
+    execution?: unknown;
+}
+export interface ConfigSaveBatchExecutionResult {
+    status: 'succeeded' | 'partial' | 'failed';
+    groups: ConfigSaveBatchGroupResult[];
+}
 export interface IssueOrigin {
     issueId: string;
     issueKey: string;
@@ -152,6 +192,10 @@ export type OperationIntent = {
     scope: Scope;
     selectedSkills: string[];
     requestedAgents?: string[];
+    retry?: {
+        receipt: PortableInstallReceipt;
+        review?: PortableRetryReview;
+    };
 } | {
     kind: 'configSave';
     pluginId: string;
@@ -163,35 +207,19 @@ export type OperationIntent = {
     removeKeys?: string[];
     sensitiveKeys?: string[];
     privateKeys?: string[];
-    changes?: Array<{
-        key: string;
-        title: string;
-        before: string;
-        after: string;
-        children?: Array<{
-            property: string;
-            before: string;
-            after: string;
-            private?: boolean;
-        }>;
-    }>;
+    changes?: ConfigOperationChange[];
+} | {
+    kind: 'configSaveBatch';
+    pluginId: string;
+    apply: boolean;
+    scriptTimeoutMs?: number;
+    groups: ConfigSaveBatchGroup[];
 } | {
     kind: 'configReset';
     pluginId: string;
     scope: Scope;
     expectedStoreState?: 'invalid';
-    changes?: Array<{
-        key: string;
-        title: string;
-        before: string;
-        after: string;
-        children?: Array<{
-            property: string;
-            before: string;
-            after: string;
-            private?: boolean;
-        }>;
-    }>;
+    changes?: ConfigOperationChange[];
 } | {
     kind: 'sourceMutation';
     action: 'add' | 'update' | 'setPrimary' | 'remove';
@@ -218,7 +246,27 @@ export type OperationIntent = {
     setPrimaryAfterActivation?: boolean;
 } | {
     kind: 'catalogSourcesRecovery';
+} | {
+    kind: 'catalogStorePrune';
 };
+export interface ConfigOperationEvidence {
+    scope: Scope;
+    schemaIdentity?: string;
+    storeDigest: string;
+    impactState?: 'known' | 'unknown';
+    noEffectiveChange?: true;
+    affectedTargets: Array<{
+        platform: PlatformName;
+        scope: Scope;
+    }>;
+    preApplyAuthorization?: PreApplyAuthorizationTarget[];
+    sharedNativeRenderTargets?: Array<{
+        id: string;
+        skillKey: string;
+        refreshKeys: string[];
+    }>;
+    shareability?: 'verified' | 'unverified';
+}
 export interface OperationEvidence {
     catalog: {
         configDigest: string;
@@ -250,23 +298,13 @@ export interface OperationEvidence {
         packageName: '@openai/codex';
         version: string;
     };
-    config?: {
-        scope: Scope;
-        schemaIdentity?: string;
-        storeDigest: string;
-        impactState?: 'known' | 'unknown';
-        noEffectiveChange?: true;
-        affectedTargets: Array<{
-            platform: PlatformName;
+    config?: ConfigOperationEvidence;
+    configBatch?: {
+        groups: Array<{
             scope: Scope;
+            config: ConfigOperationEvidence;
+            targetFingerprint: string;
         }>;
-        shareability?: 'verified' | 'unverified';
-        sharedNativeRenderTargets?: Array<{
-            id: string;
-            skillKey: string;
-            refreshKeys: string[];
-        }>;
-        preApplyAuthorization?: import('../commands/rebuild-command.js').PreApplyAuthorizationTarget[];
     };
     resetTarget?: {
         sourceId: string;
@@ -311,6 +349,7 @@ export interface OperationEvidence {
         setPrimaryAfterActivation?: boolean;
     };
     portable?: PortableReview;
+    catalogStore?: CatalogStoreTaskEvidence;
 }
 export interface OperationReviewChange {
     kind: 'add' | 'change' | 'remove' | 'keep' | 'warning';
@@ -463,6 +502,14 @@ export interface OperationResultSummary {
     configApplySkippedReason?: 'invalidConfig';
     configScope?: Scope;
     configApplyRetryAvailable?: boolean;
+    configRetryApply?: boolean;
+    configGroups?: Array<{
+        scope: Scope;
+        configSaved: boolean;
+        applyRequested: boolean;
+        applyStatus: ConfigSaveBatchGroupResult['applyStatus'];
+        errorCode?: string;
+    }>;
     resetDisposition?: 'absent' | 'deletedFile' | 'unlinkedSymlink' | 'quarantinedDirectory';
     quarantineBasename?: string;
     changes?: string[];
@@ -492,10 +539,19 @@ export interface OperationResultSummary {
         scope: Scope;
         materializationDigest: string;
         skillsCliVersion: string;
+        verified: Array<{
+            name: string;
+            scope?: string;
+            agents: string[];
+        }>;
         missing: Array<{
             skill: string;
             agent?: string;
         }>;
+        unknown: Array<{
+            skill: string;
+            agent?: string;
+        }>;
         verificationUnknown: boolean;
         recovery?: string;
         failureCode?: string;
@@ -546,6 +602,11 @@ export interface PluginOperationProgressLine {
     state: 'pending' | 'running' | 'completed' | 'kept' | 'failed' | 'skipped';
 }
 export interface TuiStatusLoadResult {
+    projectRoot?: string;
+    projectIntentRoots?: Array<{
+        pluginId: string;
+        platforms: PlatformName[];
+    }>;
     cliChannel?: 'latest' | 'beta';
     payload: StatusV8Payload;
     pluginSummaries: StatusV8PluginSummary[];
@@ -553,6 +614,7 @@ export interface TuiStatusLoadResult {
     sourceDetails?: SourceDetailViewModel[];
     configuredSources?: CatalogSource[];
     dependencyOverviews?: PluginDependencyOverviewViewModel[];
+    contentOverviews?: Record<string, PluginContentOverview>;
     portablePluginIds?: string[];
     configStoreInventory?: Array<{
         pluginId: string;
@@ -563,6 +625,17 @@ export interface TuiStatusLoadResult {
     catalogGenerations?: CatalogSourceGenerationViewModel[];
     sessionGenerationKeys?: Record<string, string>;
 }
+export interface ProjectIntentReminderTarget extends PluginWriteBatchTarget {
+    reasonCodes: string[];
+}
+export interface ProjectIntentReminder {
+    projectRoot: string;
+    signature: string;
+    actionableTargets: ProjectIntentReminderTarget[];
+    blockedTargets: ProjectIntentReminderTarget[];
+    unconfirmedTargets: PluginWriteBatchTarget[];
+}
+export declare function projectCurrentIntentReminder(status: TuiStatusLoadResult): ProjectIntentReminder | undefined;
 export interface InstallTargetOption {
     platform: PlatformName;
     compatible: boolean;
@@ -588,11 +661,14 @@ export interface TuiControllerDependencies {
         reuseValidatedGenerations?: boolean;
     }) => void;
     loadStatus: (signal: AbortSignal) => Promise<TuiStatusLoadResult>;
+    loadPluginContent?: (pluginId: string, signal: AbortSignal) => Promise<PluginContentOverview>;
     probeCatalogFreshness?: (sourceId: string, options: {
         fullValidation: boolean;
     }, signal: AbortSignal) => Promise<CatalogGenerationFreshnessResult>;
     inspectSourceRemoval?: (sourceId: string, signal: AbortSignal) => Promise<SourceReferenceSummaryViewModel>;
+    inspectCatalogStore?: (signal: AbortSignal) => Promise<CatalogStoreStatusResult>;
     captureEvidence: (intent: OperationIntent, signal?: AbortSignal) => Promise<OperationEvidence>;
+    recheckPortableInstall?: (receipt: PortableInstallReceipt, signal: AbortSignal) => Promise<PortableInstallReceipt>;
     validateIntent?: (intent: OperationIntent, signal: AbortSignal) => Promise<void>;
     prepareReviewEvidence?: (intent: OperationIntent, signal: AbortSignal, onStage: (stage: ReviewPreparationStageId) => void | Promise<void>, reusableCandidate?: CatalogSessionReusableCandidate) => Promise<OperationEvidence>;
     previewDependencyPlacement?: (intent: Extract<OperationIntent, {
@@ -659,6 +735,13 @@ export interface TuiControllerSnapshot {
         scope: Scope;
     };
     installPlacementDraft?: InstallPlacementDraftViewModel;
+    completionNotice?: {
+        pluginId: string;
+        title: string;
+        description: string;
+        operationRecordId?: string;
+    };
+    projectIntentReminder?: ProjectIntentReminder;
 }
 export declare class TuiOperationBlockedError extends Error {
     readonly code: string;
@@ -714,10 +797,13 @@ export declare class TuiController {
     refreshPortableInstallDraft(pluginId: string): Promise<PortableSkillSelectionViewModel>;
     togglePortableSkill(name: string): void;
     selectAllPortableSkills(): void;
+    clearPortableSkills(): void;
     setPortableAgentMode(mode: 'automatic' | 'explicit', requestedAgents?: string[]): void;
     setPortableScope(scope: Scope): void;
     buildPortableInstallReview(): Promise<OperationReviewModel>;
     startPortableInstallReviewPreparation(): ReviewPreparationSnapshot;
+    recheckPortableResult(): Promise<PortableInstallReceipt>;
+    startPortableRetryReviewPreparation(): ReviewPreparationSnapshot;
     discardPortableDraft(): void;
     replace(route: TuiRoute, context?: TuiPageContext): void;
     beginConfigFlow(pluginId: string): void;
@@ -750,6 +836,9 @@ export declare class TuiController {
         installFilter?: PluginInstallFilter;
     }): PluginListItemViewModel[];
     getPluginOverview(pluginId: string): PluginListItemViewModel | undefined;
+    getPluginContentOverview(pluginId: string): PluginContentOverview | undefined;
+    getPluginContentState(pluginId: string): 'idle' | 'loading' | 'ready';
+    loadPluginContent(pluginId: string): Promise<void>;
     getPluginSourceIdentity(pluginId: string): string | undefined;
     listCurrentProjectIntentRoots(): string[];
     listPluginWriteBatchTargets(action: Exclude<BatchPluginWriteAction, 'install'>, pluginIds: readonly string[]): PluginWriteBatchTarget[];
@@ -795,6 +884,7 @@ export declare class TuiController {
         sourceId: string;
     }): Promise<boolean>;
     inspectSourceRemoval(sourceId: string): Promise<SourceReferenceSummaryViewModel>;
+    inspectCatalogStore(): Promise<CatalogStoreStatusResult>;
     getConfigGroups(pluginId: string, layer: {
         scope: Scope;
     }): Promise<ConfigGroupViewModel[]>;