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

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

@@ -1,7 +1,7 @@
-import type { GeneratedArtifact, PlatformName, PluginLifecycleEvent, PluginMeta, RebuildActionEvent, RebuildActionName, RebuildCommand, Scope } from '../types.js';
-import { type LifecycleActivePluginLoader, type PreparedLifecycleActiveSnapshot, type ReadLifecycleActiveSnapshot } from '../utils/lifecycle-active-store.js';
-import type { ProcessLockLease } from '../utils/process-lock.js';
-import { type NativeOwnershipProbe, type NativeOwnershipRemove, type OwnedComponent } from '../utils/ownership.js';
+import type { GeneratedArtifact, CatalogResolution, PlatformName, PluginMeta, RebuildActionEvent, RebuildActionName, RebuildCommand, Scope } from '../types.js';
+import { type SafeOperationErrorMetadata } from '../utils/safe-operation-diagnostic.js';
+import type { OperationAction } from './operation-plan.js';
+import { type NativeOwnershipProbe, type NativeOwnershipRemove, type OwnedComponent, type OwnedComponentExecutor, type OwnershipInspection } from '../utils/ownership.js';
 export type { RebuildActionName, RebuildCommand } from '../types.js';
 export interface RebuildTargetIdentity {
     sourceId?: string;
@@ -22,8 +22,15 @@ export interface DesiredTarget {
     desiredOwnedComponents?: readonly OwnedComponent[];
     optionalOwnedComponents?: readonly OwnedComponent[];
     requiresNative: boolean;
+    writeNativeRequired?: boolean;
+    nativeOverlayDesired?: boolean;
+    codexNativeObservationExpectation?: 'observed' | 'installed';
+    codexNativeSensitivePreflightRequired?: boolean;
     artifacts: readonly GeneratedArtifact[];
-    lifecycleSource: PluginMeta;
+    operationActions?: readonly OperationAction[];
+    catalog?: CatalogResolution;
+    preApplySource: PluginMeta;
+    forceExclusiveCleanup?: boolean;
 }
 export interface RebuildAction {
     name: RebuildActionName;
@@ -33,6 +40,7 @@ export interface RebuildFailure {
     phase: RebuildActionName | 'preflight';
     message: string;
     label?: string;
+    operationDiagnostic?: SafeOperationErrorMetadata;
 }
 interface RebuildResultBase {
     command: RebuildCommand;
@@ -53,58 +61,78 @@ export interface RebuildFailedResult extends RebuildResultBase {
     error: {
         phase: RebuildFailure['phase'];
         message: string;
+        operationDiagnostic?: SafeOperationErrorMetadata;
     };
 }
 export type RebuildResult = RebuildSucceededResult | RebuildFailedResult;
-export interface RebuildLifecycleInvocation {
-    event: PluginLifecycleEvent;
+export interface RebuildPreApplyInvocation {
     target: DesiredTarget;
     plugin: PluginMeta;
-    artifacts: readonly GeneratedArtifact[];
 }
 export interface RebuildTargetDriver {
+    ownership: OwnedComponentExecutor;
+    preflightMutation?(target: DesiredTarget): Promise<void>;
     preflightMaterialize?(target: DesiredTarget): Promise<void>;
-    withMaterializeLease?<T>(target: DesiredTarget, action: () => Promise<T>): Promise<T>;
-    commitMaterialize?(target: DesiredTarget): Promise<void>;
-    rollbackMaterialize?(target: DesiredTarget): Promise<void>;
+    selectRecoveryCleanupComponents?(target: DesiredTarget, components: readonly OwnedComponent[]): readonly OwnedComponent[];
+    deferPostcheck?(target: DesiredTarget, postcheck: () => Promise<void>): boolean;
+    completePostchecks?(): Promise<readonly DeferredRebuildPostcheckFailure[]>;
     finalizeCleanup?(target: DesiredTarget): Promise<void>;
     writeNative(target: DesiredTarget): Promise<void>;
     writeArtifacts(target: DesiredTarget): Promise<void | readonly GeneratedArtifact[]>;
-    withOwnershipLease?<T>(target: DesiredTarget, action: () => Promise<T>): Promise<T>;
     probeNative?: NativeOwnershipProbe;
     probeNativeHealth?: NativeOwnershipProbe;
     removeNative?: NativeOwnershipRemove;
-    runLifecycle(invocation: RebuildLifecycleInvocation): Promise<void>;
+    runPreApply(invocation: RebuildPreApplyInvocation): Promise<void>;
 }
-export interface RebuildActiveStore {
-    prepare(target: DesiredTarget): Promise<PreparedLifecycleActiveSnapshot>;
-    discard(prepared: PreparedLifecycleActiveSnapshot): Promise<void>;
-    promote(prepared: PreparedLifecycleActiveSnapshot): Promise<ReadLifecycleActiveSnapshot | null>;
-    read(target: DesiredTarget): Promise<ReadLifecycleActiveSnapshot | null>;
-    readStable?(target: DesiredTarget): Promise<ReadLifecycleActiveSnapshot | null>;
-    remove(target: DesiredTarget): Promise<void>;
-    acquireOperation?(identity: RebuildTargetIdentity): Promise<ProcessLockLease>;
-    releaseRead?(snapshot: ReadLifecycleActiveSnapshot): Promise<void>;
+export interface DeferredRebuildPostcheckFailure {
+    target: DesiredTarget;
+    error: unknown;
 }
-export declare function createRebuildActiveStore(options: {
-    env?: NodeJS.ProcessEnv;
-    loadPlugin: LifecycleActivePluginLoader;
-    isLifecycleLeaseHeld?: () => boolean;
-}): RebuildActiveStore;
-export declare function releaseRebuildOperationLease(lock: ProcessLockLease): Promise<void>;
+export interface PreparedRebuildOperation {
+    command: RebuildCommand;
+    target: DesiredTarget;
+    inspection: OwnershipInspection;
+    actions: RebuildAction[];
+}
+export type PrepareRebuildOperationResult = {
+    status: 'ready';
+    preparation: PreparedRebuildOperation;
+} | {
+    status: 'failed';
+    result: RebuildResult;
+};
+export declare function executeRebuildComponentCleanup(options: {
+    command: RebuildCommand;
+    target: DesiredTarget;
+    driver: RebuildTargetDriver;
+    components: readonly OwnedComponent[];
+    actions?: readonly RebuildAction[];
+    onActionEvent?: (event: RebuildActionEvent) => void | Promise<void>;
+    now?: () => number;
+    beforeMutation?: (component: OwnedComponent) => Promise<void>;
+    afterQuarantine?: (component: OwnedComponent, quarantinePath: string) => Promise<void>;
+}): Promise<RebuildResult>;
 export declare function executeRebuildOperation(options: {
     command: RebuildCommand;
     target: DesiredTarget;
     driver: RebuildTargetDriver;
-    activeStore: RebuildActiveStore;
+    preparation?: PreparedRebuildOperation;
     onActionEvent?: (event: RebuildActionEvent) => void | Promise<void>;
     now?: () => number;
 }): Promise<RebuildResult>;
+export declare function prepareRebuildOperation(options: {
+    command: 'install' | 'sync' | 'reinstall';
+    target: DesiredTarget;
+    driver: RebuildTargetDriver;
+    deferNativeInspection?: boolean;
+    skipPreApply?: boolean;
+    onActionEvent?: (event: RebuildActionEvent) => void | Promise<void>;
+    now?: () => number;
+}): Promise<PrepareRebuildOperationResult>;
 export declare function executeRebuildTargets(options: {
     command: RebuildCommand;
     targets: readonly DesiredTarget[];
     driver: RebuildTargetDriver;
-    activeStore: RebuildActiveStore;
     onActionEvent?: (event: RebuildActionEvent) => void | Promise<void>;
     now?: () => number;
 }): Promise<RebuildResult[]>;