@lesliechan721/aw 0.1.0-beta.10 → 0.1.0-beta.11

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

@@ -4,16 +4,74 @@ import type { CatalogSourceUpdate } from '../utils/catalog-sources.js';
 import type { CatalogGenerationFreshnessState, CatalogGenerationFreshnessResult } from '../utils/catalog-generation-service.js';
 import type { StatusV7Payload, StatusV7PluginSummary, 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 { 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 CatalogActivationBlockReason, type ConfigInvalidStoreEvidence, type PluginInstallFilter, type PortableBlockerCode, type TuiPageContext, type TuiRoute, type TuiRouterSnapshot } from './router.js';
+import { OperationHistoryStore, type OperationDiagnosticDetail, type OperationEffectFacts, type OperationHistorySummary, type OperationReportPreview, 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';
+type CatalogActivationBlockReason = 'configDraft' | 'sourceDraft' | 'batchDraft' | 'portableDraft' | 'activeReview' | 'reviewPreparation' | 'writeProgress';
+export interface ExternalDraftState {
+    kind: 'configDraft' | 'sourceDraft' | 'batchDraft';
+    owner: string;
+    flowId?: string;
+    revision: number;
+}
 export type PluginWriteOperation = 'install' | 'refreshAndSync' | 'reinstall' | 'uninstall' | 'cleanup' | 'sync';
+export declare const PLUGIN_WRITE_BATCH_ACTIONS: readonly ["install", "sync", "reinstall", "uninstall", "cleanup"];
+export type BatchPluginWriteAction = typeof PLUGIN_WRITE_BATCH_ACTIONS[number];
+export type PluginWriteBatchSelection = {
+    kind: 'selected';
+    pluginIds: string[];
+} | {
+    kind: 'targets';
+    targets: PluginWriteBatchTarget[];
+} | {
+    kind: 'currentProjectIntentRoots';
+};
+export interface PluginWriteBatchTarget {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+}
+export interface PluginWriteBatchIntent {
+    kind: 'pluginWriteBatch';
+    action: BatchPluginWriteAction;
+    selection: PluginWriteBatchSelection;
+    platform: PlatformName | 'both';
+    scope: Scope;
+    scriptTimeoutMs?: number;
+}
+export interface PluginWriteBatchGroupEvidence {
+    groupId: string;
+    sourceId: string;
+    platform: PlatformName | 'both';
+    scope: Scope;
+    requestedPluginIds: string[];
+    preview: RebuildCommandResult;
+    executable: boolean;
+}
+export interface PluginWriteBatchEvidence extends OperationEvidence {
+    requestedPluginIds: string[];
+    groups: PluginWriteBatchGroupEvidence[];
+}
+export interface PluginWriteBatchGroupResult {
+    groupId: string;
+    sourceId: string;
+    platform: PlatformName | 'both';
+    scope: Scope;
+    requestedPluginIds: string[];
+    result: RebuildCommandResult;
+}
+export interface PluginWriteBatchExecutionResult extends RebuildCommandResult {
+    requestedPluginIds: string[];
+    groupResults: PluginWriteBatchGroupResult[];
+}
 export type OperationKind = OperationIntent['kind'];
 export interface IssueOrigin {
     issueId: string;
@@ -39,8 +97,9 @@ export type OperationIntent = {
     dependencyPlacementAdjustment?: true;
     recoveryDescription?: string;
     force?: boolean;
+    scriptTimeoutMs?: number;
     originIssue?: IssueOrigin;
-} | {
+} | PluginWriteBatchIntent | {
     kind: 'portableInstall';
     pluginId: string;
     scope: Scope;
@@ -51,6 +110,7 @@ export type OperationIntent = {
     pluginId: string;
     scope: Scope;
     apply: boolean;
+    scriptTimeoutMs?: number;
     retryApply?: true;
     updates?: Record<string, unknown>;
     removeKeys?: string[];
@@ -121,6 +181,7 @@ export interface OperationEvidence {
     source?: {
         sourceId: string;
         sourceIdentity: string;
+        logicalIdentity?: string;
         requestedRef?: string;
         resolvedCommit?: string;
         manifestDigest?: string;
@@ -149,6 +210,7 @@ export interface OperationEvidence {
             platform: PlatformName;
             scope: Scope;
         }>;
+        shareability?: 'verified' | 'unverified';
         sharedNativeRenderTargets?: Array<{
             id: string;
             skillKey: string;
@@ -186,6 +248,9 @@ export interface OperationEvidence {
         impact?: CatalogSourceImpact;
         impactDigest?: string;
         impactMode?: 'generation' | 'identityChange';
+        primaryImpact?: CatalogSourceImpact;
+        primaryImpactDigest?: string;
+        primaryConfigDigest?: string;
         configDigest: string;
         proposedConfigDigest?: string;
         proposedSource?: CatalogSource;
@@ -200,6 +265,8 @@ export interface OperationReviewChange {
     kind: 'add' | 'change' | 'remove' | 'keep' | 'warning';
     group?: 'requested' | 'dependencies' | 'projectIntent' | 'userIntent' | 'sharedCodexNative' | 'userActivation' | 'projectActivation' | 'awExtensions' | 'runtime' | 'portableTarget' | 'portableInputs' | 'portableWarnings' | 'configChanges' | 'configImpact' | 'preserved';
     pluginId?: string;
+    batchGroupId?: string;
+    sourceId?: string;
     relation?: 'requested' | 'direct' | 'transitive';
     title: string;
     description?: string;
@@ -237,6 +304,11 @@ export interface OperationReviewModel {
         catalogVersion: string;
         generationDigestShort: string;
     };
+    batch?: {
+        requestedPluginIds: string[];
+        groupCount: number;
+        executableGroupCount: number;
+    };
 }
 export type ReviewPreparationStageId = 'refresh' | 'validate' | 'status' | 'catalog' | 'inventory' | 'dependencyPlan' | 'config' | 'portable' | 'evidence';
 export interface ReviewPreparationStage {
@@ -246,10 +318,11 @@ export interface ReviewPreparationStage {
 }
 export interface ReviewPreparationSnapshot {
     id: string;
-    intent: OperationIntent;
+    operationKind: OperationIntent['kind'];
+    subject: string;
     state: 'running' | 'failed';
     stages: ReviewPreparationStage[];
-    currentLabel: string;
+    currentStage?: ReviewPreparationStageId;
     code?: 'reviewPreparationFailed';
     message?: string;
 }
@@ -264,6 +337,9 @@ export type OperationExecuteResult = {
     pluginId?: string;
     originIssue?: IssueOrigin;
     returnRoute?: TuiRoute;
+    operationRecordId?: string;
+    diagnosticIds?: string[];
+    effects?: OperationEffectFacts;
 } | {
     state: 'partial';
     operationId: string;
@@ -275,6 +351,9 @@ export type OperationExecuteResult = {
     pluginId?: string;
     originIssue?: IssueOrigin;
     returnRoute?: TuiRoute;
+    operationRecordId?: string;
+    diagnosticIds?: string[];
+    effects?: OperationEffectFacts;
 } | {
     state: 'stale';
     operationId: string;
@@ -284,6 +363,9 @@ export type OperationExecuteResult = {
     }>['action'];
     review: OperationReviewModel;
     originIssue?: IssueOrigin;
+    operationRecordId?: string;
+    diagnosticIds?: string[];
+    effects?: OperationEffectFacts;
 } | {
     state: 'blocked';
     operationId: string;
@@ -299,6 +381,9 @@ export type OperationExecuteResult = {
     writeMayHaveCompleted?: boolean;
     verification?: 'issueStillPresent' | 'verificationFailed';
     summary?: OperationResultSummary;
+    operationRecordId?: string;
+    diagnosticIds?: string[];
+    effects?: OperationEffectFacts;
 };
 export interface OperationResultSummary {
     code: 'operationSucceeded' | 'operationPartial' | 'operationFailed';
@@ -323,6 +408,14 @@ export interface OperationResultSummary {
     warnings?: string[];
     recoveryActions?: string[];
     planFingerprint?: string;
+    diagnosticIds?: string[];
+    effects?: OperationEffectFacts;
+    batch?: {
+        requestedPluginIds: string[];
+        failedRequestedPluginIds: string[];
+        retryTargets?: PluginWriteBatchTarget[];
+        groupCount: number;
+    };
     portable?: {
         selectedSkills: string[];
         agentMode: 'automatic' | 'explicit';
@@ -345,7 +438,9 @@ export interface OperationResultSummary {
         state: 'completed' | 'kept' | 'failed' | 'skipped';
         relation?: 'requested' | 'direct' | 'transitive';
         requiredBy?: string[];
-        errorCode?: 'dependencyStillRequired' | 'codexSystemCliUnsupported' | 'managedCodexAuthorizationRequired' | 'managedCodexUnavailable';
+        errorCode?: string;
+        diagnosticIds?: string[];
+        effects?: OperationEffectFacts;
     }>;
 }
 export interface PluginOperationProgressLine {
@@ -362,8 +457,15 @@ export interface TuiStatusLoadResult {
     pluginSummaries: StatusV7PluginSummary[];
     targetRevisions?: StatusTargetRevision[];
     sourceDetails?: SourceDetailViewModel[];
+    configuredSources?: CatalogSource[];
     dependencyOverviews?: PluginDependencyOverviewViewModel[];
     portablePluginIds?: string[];
+    configStoreInventory?: Array<{
+        pluginId: string;
+        sourceId: string;
+        pluginName: string;
+        scope: Scope;
+    }>;
     catalogGenerations?: CatalogSourceGenerationViewModel[];
     sessionGenerationKeys?: Record<string, string>;
 }
@@ -430,8 +532,15 @@ export interface ConfigResetAvailability {
     sourceIdentity?: string;
     storeDigest?: string;
 }
+export interface ForceCleanupCandidate {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+    actionCount: number;
+}
 export interface TuiControllerSnapshot {
     phase: 'idle' | 'loading' | 'ready' | 'error' | 'disposed';
+    statusReadAtMs?: number;
     cliChannel?: 'latest' | 'beta';
     router: TuiRouterSnapshot;
     viewModel?: TuiViewModel;
@@ -444,6 +553,8 @@ export interface TuiControllerSnapshot {
     activeReview?: OperationReviewModel;
     reviewPreparation?: ReviewPreparationSnapshot;
     result?: OperationExecuteResult;
+    operationHistorySummaries: OperationHistorySummary[];
+    portableResultSkills?: string[];
     loadError?: {
         code: string;
         message: string;
@@ -464,6 +575,8 @@ export declare class TuiConfigInvalidStoreError extends Error {
     readonly evidence: ConfigInvalidStoreEvidence[];
     constructor(evidence: ConfigInvalidStoreEvidence[]);
 }
+export declare function pluginWriteBatchFailedRequestedTargets(execution: PluginWriteBatchExecutionResult): PluginWriteBatchTarget[];
+export declare function pluginWriteBatchFailedRequestedPluginIds(execution: PluginWriteBatchExecutionResult): string[];
 export declare function operationEvidenceFingerprint(evidence: OperationEvidence): string;
 export declare function operationEvidenceMatches(expected: OperationEvidence, current: OperationEvidence): boolean;
 export declare function userIssueKey(issue: Pick<UserIssueViewModel, 'category' | 'pluginId' | 'dependencyPluginId' | 'dependencyPlatform' | 'dependencyScope' | 'dependencyProject' | 'sourceId' | 'sourceIdentity' | 'platform' | 'scope'>): string;
@@ -477,6 +590,27 @@ export declare class TuiController {
     constructor(dependencies: TuiControllerDependencies, progressFeed?: RebuildProgressFeed);
     get snapshot(): TuiControllerSnapshot;
     subscribe(listener: (snapshot: TuiControllerSnapshot) => void): () => void;
+    get hasActiveWrite(): boolean;
+    get retiring(): boolean;
+    get hasSessionDraft(): boolean;
+    get externalDrafts(): ExternalDraftState[];
+    attachOperationHistory(history: OperationHistoryStore, epoch: number): void;
+    listOperationHistory(): OperationHistorySummary[];
+    getOperationDiagnostic(recordId: string): OperationDiagnosticDetail | undefined;
+    previewOperationReport(recordId: string): OperationReportPreview | undefined;
+    saveOperationReport(recordId: string, filePath?: string): Promise<SaveOperationReportResult>;
+    /** @internal Test-only observability for bounded private diagnostic ownership. */
+    operationDiagnosticRetentionCountForTests(): number;
+    recordUiFailure(error: unknown, context: {
+        code: string;
+        stage: string;
+    }): string;
+    beginRetirement(): void;
+    waitForWrites(): Promise<void>;
+    cancelAndWaitForReads(): Promise<boolean>;
+    goHome(options?: {
+        discardDrafts?: boolean;
+    }): boolean;
     load(): Promise<void>;
     push(route: TuiRoute, context?: TuiPageContext): void;
     hasPortableSkills(pluginId: string): boolean;
@@ -491,6 +625,10 @@ export declare class TuiController {
     discardPortableDraft(): void;
     replace(route: TuiRoute, context?: TuiPageContext): void;
     beginConfigFlow(pluginId: string): void;
+    beginSavedConfigRecovery(pluginId: string): void;
+    beginConfigSourceRecovery(sourceId: string): void;
+    getForceCleanupCandidate(pluginId: string, platform: PlatformName, scope: Scope): Promise<ForceCleanupCandidate | undefined>;
+    startForceCleanupReview(candidate: ForceCleanupCandidate): ReviewPreparationSnapshot;
     configOrigin(pluginId: string): TuiRoute | undefined;
     updatePageContext(context: Partial<TuiPageContext>): void;
     back(): void;
@@ -498,6 +636,7 @@ export declare class TuiController {
         name: 'sourceList' | 'sourceDetail';
     }>): void;
     leaveResult(target?: TuiRoute): void;
+    resumeResultDraft(): void;
     resetPortableFlowToPreview(pluginId: string, target?: TuiRoute, preserveDraft?: boolean): void;
     beginInstallFlow(pluginId: string, rootScope: Scope, options?: {
         adjustingExisting?: boolean;
@@ -528,12 +667,18 @@ export declare class TuiController {
         detail?: SourceDetailViewModel;
         health?: SourceHealthViewModel;
     };
+    getConfiguredSource(sourceId: string): CatalogSource | undefined;
     getCatalogGeneration(sourceId: string): CatalogSourceGenerationViewModel | undefined;
     getCatalogFreshness(sourceId: string): CatalogSourceFreshnessViewModel | undefined;
     recheckCatalogSource(sourceId: string): Promise<void>;
+    recheckAllCatalogSources(): Promise<void>;
     fullValidateCatalogSource(sourceId: string): Promise<void>;
-    setExternalDraftState(state?: 'configDraft' | 'sourceDraft'): void;
+    setExternalDraftState(states?: ExternalDraftState[]): void;
+    beginPluginWriteBatch(): void;
+    startPluginWriteBatchReview(intent: PluginWriteBatchIntent): ReviewPreparationSnapshot;
+    retryFailedPluginWriteBatch(): ReviewPreparationSnapshot | undefined;
     catalogActivationBlockReason(): CatalogActivationBlockReason | undefined;
+    catalogSourceRecoveryBlockReason(): CatalogActivationBlockReason | undefined;
     getSessionCatalogVersion(sourceId: string): string | undefined;
     reloadCatalog(options: {
         sourceId: string;
@@ -555,3 +700,4 @@ export declare class TuiController {
     executeOperation(reviewToken: string): Promise<OperationExecuteResult>;
     dispose(): void;
 }
+export {};