@lesliechan721/aw 0.1.0-beta.13 → 0.1.0-beta.14

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

@@ -1,3 +1,4 @@
+import { type CatalogDevManagementViewModel, type CatalogManagementIntent, type CatalogManagementReviewEvidence, type CatalogManagementService, type CatalogPublicationManagementViewModel, type CatalogStoreManagementViewModel, type CatalogValidationViewModel, type CatalogWorkspaceManagementViewModel } from './catalog-management.js';
 import type { CatalogActivationMode, CatalogSource, CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogGenerationSyncResult, CatalogSourceImpact, DependencyScopeOverride, PlatformName, Scope } from '../types.js';
 import type { PortableReview } from '../portable/commands.js';
 import type { CatalogSourceUpdate } from '../utils/catalog-sources.js';
@@ -15,9 +16,11 @@ import { type ConfigInvalidStoreEvidence, type PluginInstallFilter, type Portabl
 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';
+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' | 'catalogDraft' | 'portableDraft' | 'activeReview' | 'reviewPreparation' | 'writeProgress';
 export interface ExternalDraftState {
-    kind: 'configDraft' | 'sourceDraft' | 'batchDraft';
+    kind: 'configDraft' | 'sourceDraft' | 'batchDraft' | 'catalogDraft';
     owner: string;
     flowId?: string;
     revision: number;
@@ -72,6 +75,36 @@ export interface PluginWriteBatchExecutionResult extends RebuildCommandResult {
     requestedPluginIds: string[];
     groupResults: PluginWriteBatchGroupResult[];
 }
+export interface PluginWriteTaskSourceEvidence {
+    sourceId: string;
+    sourceIdentity: string;
+    requestedTargets: PluginWriteTaskTarget[];
+    causes: PluginWriteTaskCause[];
+    preview: RebuildCommandResult;
+    executable: boolean;
+}
+export interface PluginWriteTaskEvidence extends OperationEvidence {
+    taskPlan: {
+        goal: PluginWriteTaskGoal;
+        requestedTargets: PluginWriteTaskTarget[];
+        executableTargets: PluginWriteTaskTarget[];
+        causes: PluginWriteTaskCause[];
+        blockedTargets: PluginWriteTaskBlockedTarget[];
+        sources: PluginWriteTaskSourceEvidence[];
+        targetFingerprint: string;
+        planFingerprint: string;
+    };
+}
+export interface PluginWriteTaskSourceResult {
+    sourceId: string;
+    sourceIdentity: string;
+    requestedTargets: PluginWriteTaskTarget[];
+    result: RebuildCommandResult;
+}
+export interface PluginWriteTaskExecutionResult extends RebuildCommandResult {
+    taskPlan: PluginWriteTaskEvidence['taskPlan'];
+    sourceResults: PluginWriteTaskSourceResult[];
+}
 export type OperationKind = OperationIntent['kind'];
 export interface IssueOrigin {
     issueId: string;
@@ -94,11 +127,17 @@ export type OperationIntent = {
     platform: PlatformName | 'both';
     scope: Scope;
     dependencyScopeOverrides?: DependencyScopeOverride[];
+    expectedUpdate?: {
+        installedVersion: string;
+        activeVersion: string;
+        sourceIdentity: string;
+        generationKey: string;
+    };
     recoveryDescription?: string;
     force?: boolean;
     scriptTimeoutMs?: number;
     originIssue?: IssueOrigin;
-} | PluginWriteBatchIntent | {
+} | PluginWriteBatchIntent | PluginWriteTaskIntent | {
     kind: 'portableInstall';
     pluginId: string;
     scope: Scope;
@@ -170,7 +209,7 @@ export type OperationIntent = {
     setPrimaryAfterActivation?: boolean;
 } | {
     kind: 'catalogSourcesRecovery';
-};
+} | CatalogManagementIntent;
 export interface OperationEvidence {
     catalog: {
         configDigest: string;
@@ -261,6 +300,7 @@ export interface OperationEvidence {
         }>['sourceMutation'];
         setPrimaryAfterActivation?: boolean;
     };
+    catalogManagement?: CatalogManagementReviewEvidence;
     portable?: PortableReview;
 }
 export interface OperationReviewChange {
@@ -282,6 +322,7 @@ export interface OperationReviewModel {
         kind: 'sourceMutation';
     }>['action'];
     pluginAction?: PluginWriteOperation;
+    taskGoal?: PluginWriteTaskGoal;
     originIssue?: IssueOrigin;
     title: string;
     description: string;
@@ -311,6 +352,13 @@ export interface OperationReviewModel {
         groupCount: number;
         executableGroupCount: number;
     };
+    task?: {
+        goal: PluginWriteTaskGoal;
+        requestedTargetCount: number;
+        executableTargetCount: number;
+        blockedTargetCount: number;
+        causeCount: number;
+    };
 }
 export type ReviewPreparationStageId = 'refresh' | 'validate' | 'status' | 'catalog' | 'inventory' | 'dependencyPlan' | 'config' | 'portable' | 'evidence';
 export interface ReviewPreparationStage {
@@ -395,6 +443,24 @@ export interface OperationResultSummary {
     catalogAction?: Extract<OperationIntent, {
         kind: 'catalogGeneration';
     }>['action'];
+    catalogManagement?: {
+        action: CatalogManagementIntent['action'];
+        state: 'succeeded' | 'partial';
+        catalogVersion?: string;
+        planDigest?: string;
+        store?: {
+            deletedEntries: number;
+            deletedBytes: number;
+            retainedEntries: number;
+        };
+        publication?: {
+            catalogVersion: string;
+            planDigest: string;
+            state: 'prepared' | 'uncertain' | 'published';
+            remote: string;
+            branch: string;
+        };
+    };
     catalogGeneration?: Pick<CatalogGenerationSyncResult, 'activeChanged' | 'outcome'> & {
         catalogVersion: string;
     };
@@ -415,9 +481,17 @@ export interface OperationResultSummary {
     batch?: {
         requestedPluginIds: string[];
         failedRequestedPluginIds: string[];
+        rootResults: PluginWriteBatchRootResult[];
         retryTargets?: PluginWriteBatchTarget[];
         groupCount: number;
     };
+    task?: {
+        goal: PluginWriteTaskGoal;
+        requestedTargets: PluginWriteTaskTarget[];
+        rootResults: PluginWriteTaskRootResult[];
+        retryTargets?: PluginWriteTaskTarget[];
+        blockedTargets: PluginWriteTaskBlockedTarget[];
+    };
     portable?: {
         selectedSkills: string[];
         agentMode: 'automatic' | 'explicit';
@@ -445,6 +519,31 @@ export interface OperationResultSummary {
         effects?: OperationEffectFacts;
     }>;
 }
+export interface PluginWriteTaskRootResult {
+    pluginId: string;
+    state: 'completed' | 'kept' | 'partial' | 'failed' | 'notStarted' | 'blocked';
+    causeKeys: string[];
+    targets: Array<{
+        pluginId?: string;
+        platform: PlatformName;
+        scope: Scope;
+        state: 'completed' | 'kept' | 'failed' | 'skipped';
+        relation?: 'requested' | 'direct' | 'transitive';
+        errorCode?: string;
+    }>;
+}
+export interface PluginWriteBatchRootResult {
+    pluginId: string;
+    state: 'completed' | 'kept' | 'partial' | 'failed' | 'notStarted';
+    targets: Array<{
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+        state: 'completed' | 'kept' | 'failed' | 'skipped';
+        relation: 'requested';
+        errorCode?: string;
+    }>;
+}
 export interface PluginOperationProgressLine {
     pluginId: string;
     platform: PlatformName;
@@ -492,6 +591,7 @@ export interface SourceReferenceSummaryViewModel {
     }>;
 }
 export interface TuiControllerDependencies {
+    catalogManagement?: CatalogManagementService;
     beginCatalogSession?: (options?: {
         reuseValidatedGenerations?: boolean;
     }) => void;
@@ -579,6 +679,7 @@ export declare class TuiConfigInvalidStoreError extends Error {
 }
 export declare function pluginWriteBatchFailedRequestedTargets(execution: PluginWriteBatchExecutionResult): PluginWriteBatchTarget[];
 export declare function pluginWriteBatchFailedRequestedPluginIds(execution: PluginWriteBatchExecutionResult): string[];
+export declare function pluginWriteTaskFailedRequestedTargets(execution: PluginWriteTaskExecutionResult): PluginWriteTaskTarget[];
 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;
@@ -657,6 +758,7 @@ export declare class TuiController {
     }): PluginListItemViewModel[];
     getPluginOverview(pluginId: string): PluginListItemViewModel | undefined;
     getPluginDependencyOverview(pluginId: string): PluginDependencyOverviewViewModel | undefined;
+    listPluginDependencyOverviews(): PluginDependencyOverviewViewModel[];
     getBlockingDependents(pluginId: string, platform: PlatformName, scope: Scope): PluginDependencyOverviewViewModel['dependents'];
     getPlatformPlacement(pluginId: string, platform: PlatformName): PluginListItemViewModel['installedPlacements'][number] | undefined;
     listInstallTargets(pluginId: string, scope: Scope): InstallTargetOption[];
@@ -676,9 +778,13 @@ export declare class TuiController {
     setExternalDraftState(states?: ExternalDraftState[]): void;
     beginPluginWriteBatch(): void;
     startPluginWriteBatchReview(intent: PluginWriteBatchIntent): ReviewPreparationSnapshot;
+    startPluginWriteTaskReview(intent: PluginWriteTaskIntent, returnRoute?: TuiRoute): ReviewPreparationSnapshot;
     retryFailedPluginWriteBatch(): ReviewPreparationSnapshot | undefined;
+    retryFailedPluginWriteTask(): ReviewPreparationSnapshot | undefined;
     catalogActivationBlockReason(): CatalogActivationBlockReason | undefined;
-    catalogSourceRecoveryBlockReason(): CatalogActivationBlockReason | undefined;
+    catalogSourceRecoveryBlockReason(intent?: Extract<OperationIntent, {
+        kind: 'catalogGeneration';
+    }>): CatalogActivationBlockReason | undefined;
     getSessionCatalogVersion(sourceId: string): string | undefined;
     reloadCatalog(options: {
         sourceId: string;
@@ -690,14 +796,23 @@ export declare class TuiController {
     getConfigPage(pluginId: string, layer: {
         scope: Scope | 'effective';
     }, signal?: AbortSignal): Promise<ConfigPageViewModel>;
+    selectCatalogWorkspace(workspaceRoot?: string): Promise<CatalogWorkspaceManagementViewModel>;
+    getCatalogWorkspaceManagement(): Promise<CatalogWorkspaceManagementViewModel>;
+    validateCatalogWorkspace(): Promise<CatalogValidationViewModel>;
+    getCatalogDevManagement(): Promise<CatalogDevManagementViewModel>;
+    getCatalogStoreManagement(): Promise<CatalogStoreManagementViewModel>;
+    getCatalogPublicationManagement(): Promise<CatalogPublicationManagementViewModel>;
+    previewConfigSaveImpact(intent: Extract<OperationIntent, {
+        kind: 'configSave';
+    }>, signal?: AbortSignal): Promise<NonNullable<OperationEvidence['config']>>;
     getConfigResetAvailability(pluginId: string, layer: {
         scope: Scope;
     }): Promise<ConfigResetAvailability>;
     listUserIssues(): UserIssueViewModel[];
+    listPluginWriteTaskCandidates(goal: PluginWriteTaskGoal): PluginWriteTaskCandidate[];
     buildOperationReview(intent: OperationIntent, returnRoute?: TuiRoute): Promise<OperationReviewModel>;
     startReviewPreparation(intent: OperationIntent, returnRoute?: TuiRoute): ReviewPreparationSnapshot;
     retryReviewPreparation(): ReviewPreparationSnapshot | undefined;
     executeOperation(reviewToken: string): Promise<OperationExecuteResult>;
     dispose(): void;
 }
-export {};