@lesliechan721/aw 0.1.0-beta.64 → 0.1.0-beta.66

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

@@ -1,19 +1,53 @@
-import type { CatalogResolution, CommandOptions, InstallCommandOptions, PlatformName, PluginMeta, RebuildReceiptOverallState, ReceiptTargetResult, CommandProducerResult, Scope } from '../types.js';
+import type { CatalogResolution, CommandOptions, InstallCommandOptions, PlatformName, PlatformTarget, PluginMeta, RebuildReceiptOverallState, ReceiptTargetResult, CommandProducerResult, Scope } from '../types.js';
 import { previewCodexManager, resolveCodexManager, resolveCodexOperationConsumer, type CodexManagerPreview, type ManagedCodexAuthorizer } from '../utils/codex-manager.js';
+import { type CodexManager, type NativeCliRunner } from '../utils/native-cli.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 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 { inventoryCatalogSourceReferences, type CatalogSourceReferenceInventory } from '../utils/catalog-source-references.js';
+import { inspectPluginConfigResetTarget } from '../utils/plugin-config.js';
 import { type OwnedComponent } from '../utils/ownership.js';
-import { writePluginIntentState } from '../utils/plugin-intent-state.js';
+import type { NativeDemandView } from '../utils/native-demand.js';
+import type { ScopeContext } from '../intent/scope-context.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 interface NativeExecutionInput {
+    context: ScopeContext;
+    /** Complete demand for context.scope, including targets outside this operation. */
+    requirements: NativeDemandView;
+    selectedTargets: readonly {
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+    }[];
+    preserveOtherObservedTargets: true;
+}
 export type RebuildCommandRuntime = Partial<RebuildExecutionContext> & {
+    nativePlannedRetirements?: readonly {
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+    }[];
+    nativeTargetExecution?: {
+        beforeApply(identity: RebuildTargetIdentity): Promise<CommandProducerResult[]>;
+        blocked?(identity: RebuildTargetIdentity, code: string): CommandProducerResult[];
+    };
+    configApplyPackages?: {
+        targets: Array<{
+            pluginId: string;
+            scope: Scope;
+            dependencies: string[];
+        }>;
+        evidence: unknown;
+        execute(pluginId: string, scope: Scope, token: AwHomeMutationToken): Promise<CommandProducerResult[]>;
+        blocked?(pluginId: string, scope: Scope, code: string): CommandProducerResult[];
+    };
     awHomeMutationToken?: AwHomeMutationToken;
+    executionInput?: NativeExecutionInput;
     catalogResolution?: CatalogResolution;
     resolvedCatalogPlugins?: PluginMeta[];
     namespacedSource?: {
@@ -44,7 +78,6 @@ export type RebuildCommandRuntime = Partial<RebuildExecutionContext> & {
     codexManagerPreviewer?: typeof previewCodexManager;
     onPreviewStage?: (stage: 'catalog' | 'inventory' | 'dependencyPlan') => Promise<void> | void;
     removeObsoleteInstallationContracts?: (directory: string) => Promise<void>;
-    writePluginIntentState?: typeof writePluginIntentState;
     executeCleanupOperation?: typeof executeRebuildOperation;
     operationDiagnosticSink?: (results: readonly RebuildResult[]) => void;
 };
@@ -97,10 +130,18 @@ export interface RebuildCommandResult {
     }>;
     dependencyPlan?: ReconcileOperationPlan;
     codexReconcilePlans?: CodexReconcilePlan[];
+    /** In-memory physical output paths from the prepared targets; never persisted. */
+    nativeFootprints?: Array<{
+        path: string;
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+        shared: boolean;
+        sharedMarketplace?: boolean;
+    }>;
     operationPlan?: OperationPlan;
     codexManagerPreview?: CodexManagerPreview;
     offlineCleanupPlans?: OfflineCleanupTargetEvidence[];
-    removedPluginCleanupIds?: string[];
     preApplyAuthorization?: PreApplyAuthorizationTarget[];
 }
 export interface PreApplyAuthorizationTarget {
@@ -108,7 +149,7 @@ export interface PreApplyAuthorizationTarget {
     pluginName: string;
     sourceId: string;
     sourceIdentity: string;
-    platform: PlatformName;
+    platform: PlatformTarget;
     scope: Scope;
     relation: 'requested' | 'direct' | 'transitive';
 }
@@ -121,6 +162,67 @@ export interface RebuildCommandTestHooks {
     afterActivationLegacyCleanupQuarantine?: (component: OwnedComponent, quarantinePath: string) => Promise<void>;
 }
 export declare function setRebuildCommandTestHooksForTests(hooks: RebuildCommandTestHooks | undefined): void;
+export type RemovedPluginCleanupTarget = {
+    pluginId: string;
+    pluginName: string;
+    sourceId: string;
+    sourceIdentity: string;
+    logicalIdentity: string;
+    snapshotDigest: string;
+    marketplaceRoot: string;
+    marketplaceName?: string;
+    nativeOwnershipVerified: boolean;
+    projectionOwnershipVerified: boolean;
+    claudeNativeCleanupBlocked: boolean;
+    nativeState: 'installed' | 'absent' | 'unknown' | 'unbound';
+    nativeObservationFingerprint: string;
+    marketplaceEvidenceFingerprint: string;
+    projectionFingerprint: string;
+    projectionPresent: boolean;
+    activationScopes: Array<{
+        scope: Scope;
+        enabled: boolean | undefined;
+    }>;
+    configTargets: Array<{
+        scope: Scope;
+        kind: Awaited<ReturnType<typeof inspectPluginConfigResetTarget>>['kind'];
+        fingerprint: string;
+    }>;
+    evidence: OfflineCleanupTargetEvidence[];
+    blockers: string[];
+};
+export declare function inspectRemovedPluginConfig(options: {
+    sourceId: string;
+    sourceIdentity: string;
+    logicalIdentity: string;
+    pluginName: string;
+    scope: Scope;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<{
+    kind: Awaited<ReturnType<typeof inspectPluginConfigResetTarget>>['kind'];
+    fingerprint: string;
+    conflict?: string;
+}>;
+export declare function inspectRemovedPluginCleanup(options: {
+    pluginId: string;
+    scope: Scope;
+    inventory: CatalogSourceReferenceInventory;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    nativeCliRunner: NativeCliRunner;
+    codexManager?: CodexManager;
+}): Promise<RemovedPluginCleanupTarget | null>;
+export declare function executeRemovedPluginOutputCleanup(options: {
+    target: RemovedPluginCleanupTarget;
+    selectedTargets: readonly {
+        pluginId: string;
+        platform: PlatformName;
+        scope: Scope;
+    }[];
+    context: ScopeContext;
+    runtime?: RebuildCommandRuntime;
+}): Promise<RebuildCommandResult>;
 export declare function runRebuildCommand(options: RebuildCommandInvocation): Promise<RebuildCommandResult>;
 export declare function runRebuildTaskCommand(targets: readonly RebuildTaskTarget[], options: RebuildTaskCommandOptions, runtime?: RebuildCommandRuntime): Promise<RebuildCommandResult>;
 export {};