@lesliechan721/aw 0.1.0-beta.63 → 0.1.0-beta.65

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

@@ -1,5 +1,5 @@
 import type { ConfigReferenceContext, ConfigReferenceDraft } from './config-references.js';
-import type { CatalogActivationMode, CatalogSource, CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogGenerationSyncResult, CatalogSourceImpact, CommandProducerResult, DependencyScopeOverride, PlatformName, Scope } from '../types.js';
+import type { CatalogActivationMode, CatalogSource, CatalogGenerationActiveV1, CatalogGenerationCandidateEvidence, CatalogGenerationSyncResult, CatalogSourceImpact, CommandProducerResult, DependencyScopeOverride, PlatformName, PlatformTarget, Scope } from '../types.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';
@@ -11,11 +11,15 @@ import type { CodexReconcilePlan } from '../utils/codex-reconciler.js';
 import type { PluginConfigMutationImpact } from '../utils/plugin-config-impact.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 ConfigPageViewModel, type ConfigProfileOptions, type ConfigReadOptions, type ConfigProfileKey, 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 { type PluginDetailSubject } from './plugin-detail.js';
 import { OperationHistoryStore, type OperationDiagnosticDetail, type OperationEffectFacts, type OperationHistorySummary, type OperationReportPreview, type SafeOperationDiagnostic, type SaveOperationReportResult } from './operation-history.js';
-import { type ProjectInventoryRoot, type ProjectInventoryViewModel } from './project-inventory.js';
+import { type RecoveryInventoryInput, type ScopedInventoryViewModel, type ScopedInventoryLoadResult, type InventoryRoot } from './scoped-inventory.js';
+import type { ScopedTuiPlan } from './scoped-flow.js';
+import type { RecoveryReceipt } from '../recovery/receipt.js';
+import type { RecoveryCommand } from '../recovery/coordinator.js';
+import type { AgentId } from '../intent/deployment-preferences.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';
@@ -40,11 +44,6 @@ export type PluginWriteBatchSelection = {
 } | {
     kind: 'targets';
     targets: PluginWriteBatchTarget[];
-} | {
-    kind: 'currentProjectIntentTargets';
-    targets: PluginWriteBatchTarget[];
-} | {
-    kind: 'currentProjectIntentRoots';
 };
 export interface PluginWriteBatchTarget {
     pluginId: string;
@@ -59,6 +58,7 @@ export declare function pluginWriteBatchTargets(action: Exclude<BatchPluginWrite
 export interface PluginWriteBatchIntent {
     kind: 'pluginWriteBatch';
     dependencyScopeOverrides?: DependencyScopeOverride[];
+    saveDependencyScopeOverrides?: boolean;
     action: BatchPluginWriteAction;
     selection: PluginWriteBatchSelection;
     platform: PlatformName | 'both';
@@ -141,7 +141,8 @@ export interface ConfigOperationChange {
 }
 export interface ConfigSaveBatchGroup {
     editEvidence?: Record<string, import('./model.js').ConfigEditEvidence>;
-    scope: Scope;
+    scope?: 'user';
+    platform?: PlatformTarget;
     updates?: Record<string, unknown>;
     removeKeys?: string[];
     sensitiveKeys?: string[];
@@ -149,7 +150,8 @@ export interface ConfigSaveBatchGroup {
     changes?: ConfigOperationChange[];
 }
 export interface ConfigSaveBatchGroupResult {
-    scope: Scope;
+    scope: 'user';
+    platform?: PlatformTarget;
     status: 'succeeded' | 'failed';
     configSaved: boolean;
     applyRequested: boolean;
@@ -161,6 +163,14 @@ export interface ConfigSaveBatchExecutionResult {
     status: 'succeeded' | 'partial' | 'failed';
     groups: ConfigSaveBatchGroupResult[];
 }
+export interface ConfigDraftSaveResult {
+    status: 'succeeded' | 'partial' | 'failed';
+    savedProfiles: ConfigProfileKey[];
+    failedProfiles: Array<{
+        profile: ConfigProfileKey;
+        errorCode?: string;
+    }>;
+}
 export interface IssueOrigin {
     issueId: string;
     issueKey: string;
@@ -182,6 +192,7 @@ export type OperationIntent = {
     platform: PlatformName | 'both';
     scope: Scope;
     dependencyScopeOverrides?: DependencyScopeOverride[];
+    saveDependencyScopeOverrides?: boolean;
     expectedUpdate?: {
         installedVersion: string;
         activeVersion: string;
@@ -205,10 +216,14 @@ export type OperationIntent = {
 } | {
     kind: 'configSave';
     pluginId: string;
-    scope: Scope;
+    scope?: 'user';
+    platform?: PlatformTarget;
+    context?: Scope;
     apply: boolean;
+    targets?: PlatformTarget[];
     scriptTimeoutMs?: number;
     retryApply?: true;
+    editEvidence?: Record<string, import('./model.js').ConfigEditEvidence>;
     updates?: Record<string, unknown>;
     removeKeys?: string[];
     sensitiveKeys?: string[];
@@ -217,13 +232,16 @@ export type OperationIntent = {
 } | {
     kind: 'configSaveBatch';
     pluginId: string;
+    context?: Scope;
     apply: boolean;
     scriptTimeoutMs?: number;
     groups: ConfigSaveBatchGroup[];
 } | {
     kind: 'configReset';
     pluginId: string;
-    scope: Scope;
+    scope?: 'user';
+    platform?: PlatformTarget;
+    context?: Scope;
     expectedStoreState?: 'invalid';
     changes?: ConfigOperationChange[];
 } | {
@@ -256,16 +274,25 @@ export type OperationIntent = {
     kind: 'catalogStorePrune';
 };
 export interface ConfigOperationEvidence {
-    scope: Scope;
+    scope: 'user';
+    platform?: PlatformTarget;
+    context?: Scope;
     schemaIdentity?: string;
     storeDigest: string;
     impactState?: 'known' | 'unknown';
     noEffectiveChange?: true;
     affectedTargets: Array<{
         pluginName?: string;
-        platform: PlatformName;
+        platform: PlatformTarget;
         scope: Scope;
     }>;
+    applyEvidence?: unknown;
+    applyChanges?: string[];
+    applyWarnings?: string[];
+    applyBlockers?: Array<{
+        code: string;
+        message: string;
+    }>;
     commandPackages?: PluginConfigMutationImpact['affectedCommandPackages'];
     preApplyAuthorization?: PreApplyAuthorizationTarget[];
     sharedNativeRenderTargets?: Array<{
@@ -312,7 +339,8 @@ export interface OperationEvidence {
     config?: ConfigOperationEvidence;
     configBatch?: {
         groups: Array<{
-            scope: Scope;
+            scope: 'user';
+            platform?: PlatformTarget;
             config: ConfigOperationEvidence;
             targetFingerprint: string;
         }>;
@@ -320,7 +348,9 @@ export interface OperationEvidence {
     resetTarget?: {
         sourceId: string;
         pluginName: string;
-        scope: Scope;
+        scope: 'user';
+        platform?: PlatformTarget;
+        context?: Scope;
         kind: 'absent' | 'regularFile' | 'symbolicLink' | 'directory';
         fingerprint: string;
     };
@@ -532,10 +562,20 @@ export interface OperationResultSummary {
     configApplied?: boolean;
     configApplySkippedReason?: 'invalidConfig';
     configScope?: Scope;
+    configPlatform?: PlatformTarget;
+    configContext?: Scope;
+    configTargets?: Array<{
+        pluginId?: string;
+        platform: PlatformTarget;
+        scope: Scope;
+        state: 'completed' | 'kept' | 'failed' | 'skipped';
+        errorCode?: string;
+    }>;
     configApplyRetryAvailable?: boolean;
     configRetryApply?: boolean;
     configGroups?: Array<{
         scope: Scope;
+        platform?: PlatformTarget;
         configSaved: boolean;
         applyRequested: boolean;
         applyStatus: ConfigSaveBatchGroupResult['applyStatus'];
@@ -638,25 +678,8 @@ export interface PluginOperationProgressLine {
     state: 'pending' | 'running' | 'completed' | 'kept' | 'failed' | 'skipped';
 }
 export interface TuiStatusLoadResult {
+    scopedRecovery?: Partial<Record<Scope, RecoveryInventoryInput & Partial<Pick<ScopedInventoryLoadResult, 'nativeSnapshot'>>>>;
     projectRoot?: string;
-    projectIntent?: {
-        state: 'ready';
-        roots: Array<{
-            pluginId: string;
-            platforms: PlatformName[];
-        }>;
-    } | {
-        state: 'absent';
-    } | {
-        state: 'invalid' | 'unavailable';
-        code: string;
-        message: string;
-    };
-    /** Compatibility input for older injected status fixtures. Production uses projectIntent. */
-    projectIntentRoots?: Array<{
-        pluginId: string;
-        platforms: PlatformName[];
-    }>;
     cliChannel?: 'latest' | 'beta';
     payload: StatusV8Payload;
     pluginSummaries: StatusV8PluginSummary[];
@@ -675,17 +698,6 @@ 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: ProjectIntentReminderTarget[];
-}
-export declare function projectCurrentIntentReminder(status: TuiStatusLoadResult): ProjectIntentReminder | undefined;
 export interface InstallTargetOption {
     platform: PlatformName;
     compatible: boolean;
@@ -707,10 +719,58 @@ export interface SourceReferenceSummaryViewModel {
     }>;
 }
 export interface TuiControllerDependencies {
+    readAgentSettings?: () => Promise<import('./agent-settings.js').AgentSettings>;
+    previewAgentSettings?: (preferences: import('../intent/deployment-preferences.js').DeploymentPreferences, pluginId?: string) => Promise<import('./agent-settings.js').AgentSettingsPreview>;
+    saveAgentSettings?: (request: Parameters<typeof import('./agent-settings.js').saveAgentSettings>[1]) => Promise<import('./agent-settings.js').AgentSettings>;
     beginCatalogSession?: (options?: {
         reuseValidatedGenerations?: boolean;
     }) => void;
     loadStatus: (signal: AbortSignal) => Promise<TuiStatusLoadResult>;
+    loadScopedStatus?: (scope: Scope, signal: AbortSignal) => Promise<ScopedInventoryLoadResult>;
+    prepareScopedTask?: (request: {
+        scope: Scope;
+        kind: 'recovery';
+        command?: RecoveryCommand;
+        selectors: string[];
+        exactTargets?: Array<{
+            pluginId: string;
+            agent: AgentId;
+        }>;
+        targets?: AgentId[];
+        force?: boolean;
+        refresh?: boolean;
+        retireUnselectedTargets?: boolean;
+        dependencyScopeOverrides?: DependencyScopeOverride[];
+        saveDependencyScopeOverrides?: boolean;
+        scriptTimeoutMs?: number;
+    } | {
+        scope: Scope;
+        kind: 'targets';
+        action: 'set' | 'reset';
+        agents: string[];
+    } | {
+        scope: Scope;
+        kind: 'retire';
+        selector: string;
+        targets?: AgentId[];
+        deleteConfig?: boolean;
+    } | {
+        scope: Scope;
+        kind: 'intent';
+        action: 'add' | 'remove';
+        selector: string;
+    }, signal: AbortSignal) => Promise<ScopedTuiPlan>;
+    executeScopedTask?: (plan: ScopedTuiPlan) => Promise<{
+        kind: 'recovery';
+        receipt: RecoveryReceipt;
+    } | {
+        kind: 'recoveryReview';
+        plan: ScopedTuiPlan;
+    } | {
+        kind: 'targets';
+        changed: boolean;
+        agents: AgentId[];
+    }>;
     loadPluginContent?: (pluginId: string, signal: AbortSignal) => Promise<PluginContentOverview>;
     probeCatalogFreshness?: (sourceId: string, options: {
         fullValidation: boolean;
@@ -725,16 +785,10 @@ export interface TuiControllerDependencies {
         kind: 'pluginWrite';
     }>, signal: AbortSignal) => Promise<ReconcileOperationPlan | undefined>;
     executeIntent: (intent: OperationIntent, expectedEvidence: OperationEvidence, signal?: AbortSignal) => Promise<unknown>;
-    getConfigGroups?: (pluginId: string, layer: {
-        scope: Scope;
-    }, signal: AbortSignal) => Promise<ConfigGroupViewModel[]>;
-    getConfigPage?: (pluginId: string, layer: {
-        scope: Scope | 'effective';
-    }, signal: AbortSignal) => Promise<ConfigPageViewModel>;
-    getConfigReferenceContext?: (pluginId: string, scope: Scope, draft: ConfigReferenceDraft, signal: AbortSignal) => Promise<ConfigReferenceContext>;
-    getConfigResetAvailability?: (pluginId: string, layer: {
-        scope: Scope;
-    }, signal: AbortSignal) => Promise<ConfigResetAvailability>;
+    getConfigGroups?: (pluginId: string, options: ConfigReadOptions, signal: AbortSignal) => Promise<ConfigGroupViewModel[]>;
+    getConfigPage?: (pluginId: string, options: ConfigReadOptions, signal: AbortSignal) => Promise<ConfigPageViewModel>;
+    getConfigReferenceContext?: (pluginId: string, options: ConfigProfileOptions, draft: ConfigReferenceDraft, signal: AbortSignal) => Promise<ConfigReferenceContext>;
+    getConfigResetAvailability?: (pluginId: string, options: ConfigProfileOptions, signal: AbortSignal) => Promise<ConfigResetAvailability>;
     logError?: (error: unknown, code: string, context?: {
         privateConfigOperation: boolean;
     }) => void | Promise<void>;
@@ -793,19 +847,12 @@ export interface TuiControllerSnapshot {
         description: string;
         operationRecordId?: string;
     };
-    projectIntentReminder?: ProjectIntentReminder;
-    projectInventory?: ProjectInventoryViewModel;
-    projectInventoryRefresh: {
+    projectRoot?: string;
+    scopedInventories: Partial<Record<Scope, ScopedInventoryViewModel>>;
+    scopedInventoryRefresh: Partial<Record<Scope, {
         state: 'idle' | 'checking' | 'error';
-        checkedAtMs?: number;
         errorCode?: string;
-    };
-    projectDeclarationAbsent?: boolean;
-    projectIntentIssue?: {
-        state: 'invalid' | 'unavailable';
-        code: string;
-        message: string;
-    };
+    }>>;
 }
 export declare class TuiOperationBlockedError extends Error {
     readonly code: string;
@@ -855,9 +902,15 @@ export declare class TuiController {
         discardDrafts?: boolean;
     }): boolean;
     load(): Promise<void>;
-    listProjectInventoryRoots(section?: 'declared' | 'extraInstalled'): ProjectInventoryRoot[];
-    getProjectInventoryRoot(pluginId: string): ProjectInventoryRoot | undefined;
-    refreshProjectInventory(): Promise<boolean>;
+    listScopedInventoryRoots(scope: Scope, section?: 'declared' | 'extraInstalled'): InventoryRoot[];
+    refreshScopedInventory(scope: Scope): Promise<boolean>;
+    prepareScopedTask(request: Parameters<NonNullable<TuiControllerDependencies['prepareScopedTask']>>[0]): Promise<ScopedTuiPlan>;
+    readAgentSettings(): Promise<import('./agent-settings.js').AgentSettings>;
+    previewAgentSettings(preferences: import('../intent/deployment-preferences.js').DeploymentPreferences, pluginId?: string): Promise<import('./agent-settings.js').AgentSettingsPreview>;
+    saveAgentSettings(request: Parameters<typeof import('./agent-settings.js').saveAgentSettings>[1]): Promise<import('./agent-settings.js').AgentSettings>;
+    cancelScopedPreparation(): void;
+    discardScopedPlan(plan: ScopedTuiPlan): Promise<void>;
+    executeScopedTask(plan: ScopedTuiPlan): ReturnType<NonNullable<TuiControllerDependencies['executeScopedTask']>>;
     push(route: TuiRoute, context?: TuiPageContext): void;
     hasPortableSkills(pluginId: string): boolean;
     preparePortableInstall(pluginId: string, navigation?: 'push' | 'replace'): Promise<PortableSkillSelectionViewModel>;
@@ -873,12 +926,12 @@ export declare class TuiController {
     startPortableRetryReviewPreparation(): ReviewPreparationSnapshot;
     discardPortableDraft(): void;
     replace(route: TuiRoute, context?: TuiPageContext): void;
-    beginConfigFlow(pluginId: string): void;
+    beginConfigFlow(pluginId: string, options?: ConfigProfileOptions): void;
     beginConfigReferenceSource(pluginId: string, fieldKey: string): void;
     beginSavedConfigRecovery(pluginId: string): void;
     beginConfigSourceRecovery(sourceId: string): void;
     getForceCleanupCandidate(pluginId: string, platform: PlatformName, scope: Scope): Promise<ForceCleanupCandidate | undefined>;
-    startForceCleanupReview(candidate: ForceCleanupCandidate): ReviewPreparationSnapshot;
+    startForceCleanupReview(candidate: ForceCleanupCandidate): Promise<ScopedTuiPlan>;
     configOrigin(pluginId: string): TuiRoute | undefined;
     updatePageContext(context: Partial<TuiPageContext>): void;
     returnToConfigOverview(flowId: string | undefined, overviewFrameId: string | undefined, pluginId: string, context?: TuiPageContext): boolean;
@@ -957,19 +1010,16 @@ export declare class TuiController {
     }): Promise<boolean>;
     inspectSourceRemoval(sourceId: string): Promise<SourceReferenceSummaryViewModel>;
     inspectCatalogStore(): Promise<CatalogStoreStatusResult>;
-    getConfigGroups(pluginId: string, layer: {
-        scope: Scope;
-    }): Promise<ConfigGroupViewModel[]>;
-    getConfigPage(pluginId: string, layer: {
-        scope: Scope | 'effective';
-    }, signal?: AbortSignal): Promise<ConfigPageViewModel>;
-    getConfigReferenceContext(pluginId: string, scope: Scope, draft: ConfigReferenceDraft, signal?: AbortSignal): Promise<ConfigReferenceContext>;
+    getConfigGroups(pluginId: string, options: ConfigReadOptions): Promise<ConfigGroupViewModel[]>;
+    getConfigPage(pluginId: string, options: ConfigReadOptions, signal?: AbortSignal): Promise<ConfigPageViewModel>;
+    getConfigReferenceContext(pluginId: string, options: ConfigProfileOptions, draft: ConfigReferenceDraft, signal?: AbortSignal): Promise<ConfigReferenceContext>;
+    saveConfigDraft(request: Extract<OperationIntent, {
+        kind: 'configSave' | 'configSaveBatch';
+    }>, signal?: AbortSignal): Promise<ConfigDraftSaveResult>;
     previewConfigSaveImpact(intent: Extract<OperationIntent, {
         kind: 'configSave';
     }>, signal?: AbortSignal): Promise<NonNullable<OperationEvidence['config']>>;
-    getConfigResetAvailability(pluginId: string, layer: {
-        scope: Scope;
-    }): Promise<ConfigResetAvailability>;
+    getConfigResetAvailability(pluginId: string, options: ConfigProfileOptions): Promise<ConfigResetAvailability>;
     listUserIssues(): UserIssueViewModel[];
     listPluginWriteTaskCandidates(goal: PluginWriteTaskGoal): PluginWriteTaskCandidate[];
     buildOperationReview(intent: OperationIntent, returnRoute?: TuiRoute): Promise<OperationReviewModel>;