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

package/dist/src/commands/rebuild-command.d.ts

@@ -1,39 +1,80 @@
-import type { CatalogResolution, CommandOptions, GeneratedArtifact, PlatformName, ReceiptOverallState, ReceiptTargetResult, Scope } from '../types.js';
-import { type RebuildCommand, type RebuildResult, type RebuildTargetIdentity } from './rebuild-operations.js';
-import { type PreparedRebuildTarget, type RebuildExecutionContext } from './rebuild-integration.js';
+import type { CatalogResolution, CommandOptions, InstallCommandOptions, PlatformName, PluginMeta, RebuildReceiptOverallState, ReceiptTargetResult, Scope } from '../types.js';
+import { previewCodexManager, resolveCodexManager, resolveCodexOperationConsumer, type CodexManagerPreview, type ManagedCodexAuthorizer } from '../utils/codex-manager.js';
+import { type CodexReconcilePlan } from '../utils/codex-reconciler.js';
+import { executeRebuildOperation, type RebuildCommand, type RebuildResult, type RebuildTargetIdentity } from './rebuild-operations.js';
+import { type RebuildExecutionContext } from './rebuild-integration.js';
 import type { AwHomeMutationToken } from '../utils/aw-home-mutation-lock.js';
-import { type DependencyOperationPlan } from './dependency-operation-plan.js';
+import { type CatalogOperationContext } from '../utils/catalog-operation-context.js';
+import type { CatalogGenerationServiceRuntime } from '../utils/catalog-generation-service.js';
+import { inventoryCatalogSourceReferences } from '../utils/catalog-source-references.js';
+import { type OwnedComponent } from '../utils/ownership.js';
+import { writePluginIntentState } from '../utils/plugin-intent-state.js';
+import { type OperationPlan } from './operation-plan.js';
+import { type ReconcileOperationPlan } from './reconcile-operation-plan.js';
+import { type OfflineCleanupTargetEvidence } from './offline-cleanup-evidence.js';
 export type RebuildCommandRuntime = Partial<RebuildExecutionContext> & {
     awHomeMutationToken?: AwHomeMutationToken;
     catalogResolution?: CatalogResolution;
+    resolvedCatalogPlugins?: PluginMeta[];
     namespacedSource?: {
         sourceId: string;
         sourceIdentity: string;
+        logicalIdentity: string;
         marketplaceName: string;
         marketplaceRoot: string;
     };
     expectedCatalogConfigDigest?: string;
+    expectedGenerationSetDigest?: string;
+    catalogOperationContext?: CatalogOperationContext;
+    catalogBootstrapError?: unknown;
+    catalogGenerationRuntime?: CatalogGenerationServiceRuntime;
+    inventoryCatalogSourceReferences?: typeof inventoryCatalogSourceReferences;
+    expectedPlanFingerprint?: string;
+    expectedOfflineCleanupEvidence?: OfflineCleanupTargetEvidence;
     reviewPreflight?: (evidence: RebuildReviewPreflightEvidence) => Promise<void> | void;
     resolvedReviewEvidenceByPlugin?: Record<string, Omit<RebuildReviewPreflightEvidence, 'command' | 'identity'>>;
-    operationLeaseHeld?: boolean;
-    bypassDependencyPlan?: boolean;
-    dependencyReviewPreflightHandled?: boolean;
-    previewDependencyPlanOnly?: boolean;
-    targetBuiltHookHandled?: boolean;
-    preparedTarget?: PreparedRebuildTarget;
-    preparedTargetError?: unknown;
+    previewOperationPlan?: boolean;
+    resolvePreApplyAuthorization?: boolean;
+    preApplyConfirmed?: boolean;
+    scriptTimeoutMs?: number;
+    directCli?: boolean;
+    managedCodexAuthorizer?: ManagedCodexAuthorizer;
+    codexManagerResolver?: typeof resolveCodexManager;
+    codexOperationConsumerResolver?: typeof resolveCodexOperationConsumer;
+    codexManagerPreviewer?: typeof previewCodexManager;
+    onPreviewStage?: (stage: 'catalog' | 'inventory' | 'dependencyPlan') => Promise<void> | void;
     removeObsoleteInstallationContracts?: (directory: string) => Promise<void>;
-    corruptExclusiveDirectoryOperations?: {
-        rename?: (source: string, destination: string) => Promise<void>;
-        remove?: (target: string) => Promise<void>;
-    };
+    writePluginIntentState?: typeof writePluginIntentState;
+    executeCleanupOperation?: typeof executeRebuildOperation;
+    operationDiagnosticSink?: (results: readonly RebuildResult[]) => void;
+};
+export interface RebuildTaskTarget {
+    pluginId: string;
+    platform: PlatformName;
+    scope: Scope;
+    method: 'sync' | 'reinstall';
+}
+export type RebuildTaskCommandOptions = Omit<InstallCommandOptions, 'platform' | 'scope'> & {
+    repairTargets?: readonly RebuildTaskTarget[];
+};
+type RebuildCommandInvocation = {
+    command: RebuildCommand;
+    pluginNames: string[];
+    commandOptions: CommandOptions;
+    runtime?: RebuildCommandRuntime;
+    all?: boolean;
+    taskTargets?: readonly RebuildTaskTarget[];
+    taskRepairTargets?: readonly RebuildTaskTarget[];
 };
+export type CommandPerformanceStageName = 'catalog.load' | 'catalog.validation' | 'inventory' | 'dependency.plan' | 'target.build';
 export interface RebuildReviewPreflightEvidence {
     command: RebuildCommand;
     identity: RebuildTargetIdentity;
     configDigest?: string;
+    generationSetDigest?: string;
     sourceId?: string;
     sourceIdentity?: string;
+    logicalIdentity?: string;
     resolvedCommit?: string;
     manifestDigest?: string;
     snapshotDigest?: string;
@@ -45,9 +86,7 @@ export interface RebuildCommandResult {
     warnings: string[];
     rebuildResults: RebuildResult[];
     targetResults: ReceiptTargetResult[];
-    overallState: ReceiptOverallState;
-    nativePlugins: Partial<Record<PlatformName, string[]>>;
-    repoManagedArtifacts: GeneratedArtifact[];
+    overallState: RebuildReceiptOverallState;
     receiptTargets: Array<{
         pluginName: string;
         pluginId?: string;
@@ -55,23 +94,31 @@ export interface RebuildCommandResult {
         platform: PlatformName;
         scope: Scope;
     }>;
-    dependencyPlan?: DependencyOperationPlan;
+    dependencyPlan?: ReconcileOperationPlan;
+    codexReconcilePlans?: CodexReconcilePlan[];
+    operationPlan?: OperationPlan;
+    codexManagerPreview?: CodexManagerPreview;
+    offlineCleanupPlans?: OfflineCleanupTargetEvidence[];
+    preApplyAuthorization?: PreApplyAuthorizationTarget[];
+}
+export interface PreApplyAuthorizationTarget {
+    pluginId: string;
+    pluginName: string;
+    sourceId: string;
+    sourceIdentity: string;
+    platform: PlatformName;
+    scope: Scope;
+    relation: 'requested' | 'direct' | 'transitive';
 }
 export interface RebuildCommandTestHooks {
-    beforeOperationLockAcquire?: (options: {
-        command: RebuildCommand;
-        identity: RebuildTargetIdentity;
-    }) => Promise<void>;
     afterTargetBuilt?: (options: {
         command: RebuildCommand;
         identity: RebuildTargetIdentity;
     }) => Promise<void>;
+    beforeActivationLegacyCleanupMutation?: (component: OwnedComponent) => Promise<void>;
+    afterActivationLegacyCleanupQuarantine?: (component: OwnedComponent, quarantinePath: string) => Promise<void>;
 }
 export declare function setRebuildCommandTestHooksForTests(hooks: RebuildCommandTestHooks | undefined): void;
-export declare function runRebuildCommand(options: {
-    command: RebuildCommand;
-    pluginNames: string[];
-    commandOptions: CommandOptions;
-    runtime?: RebuildCommandRuntime;
-    all?: boolean;
-}): Promise<RebuildCommandResult>;
+export declare function runRebuildCommand(options: RebuildCommandInvocation): Promise<RebuildCommandResult>;
+export declare function runRebuildTaskCommand(targets: readonly RebuildTaskTarget[], options: RebuildTaskCommandOptions, runtime?: RebuildCommandRuntime): Promise<RebuildCommandResult>;
+export {};