@lesliechan721/aw 0.1.0-beta.6 → 0.1.0-beta.61

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

@@ -1,11 +1,25 @@
-import type { CatalogResolution, CodexSharedHookGroup, PlatformName, PluginMeta, Scope } from '../types.js';
+import { type ManagedCommandCandidate } from '../utils/managed-command-materialization.js';
+import type { CatalogResolution, CommandProducerResult, PlatformName, PluginMeta, Scope } from '../types.js';
 import type { CommandReporter, DebugLogger } from '../output/model.js';
-import { parseCodexSharedHooksFile } from '../utils/hooks-contract.js';
-import { type NativeCliRunner } from '../utils/native-cli.js';
-import { type OwnershipInspection } from '../utils/ownership.js';
+import { type CodexManager, type NativeCliRunner } from '../utils/native-cli.js';
+import { type NativeOwnershipProbe, type OwnershipInspection } from '../utils/ownership.js';
+import type { CodexReconcilePlan } from '../utils/codex-reconciler.js';
+import { type CodexSharedNativeInspection } from '../utils/codex-shared-native.js';
+import { type CodexNativeObservationSession, type CodexNativePluginObservation } from '../utils/codex-native-observation.js';
 import type { DesiredTarget, RebuildTargetDriver } from './rebuild-operations.js';
+/** Normal write preparation compares its real candidate; read-only inspection never calls this. */
+export declare function hasPreparedStaticNativeCommandDrift(options: {
+    plugin: PluginMeta;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    context: RebuildExecutionContext;
+    marketplaceRoot: string;
+}): Promise<boolean>;
 export interface RebuildIntegration {
     driver: RebuildTargetDriver;
+    setNativeMarketplaceEligibleTargets(targets: readonly DesiredTarget[]): void;
+    prepareNativeMarketplaceGroup(target: DesiredTarget): Promise<void>;
+    captureCodexPostMutationSnapshots(marketplaceNames?: readonly string[]): Promise<void>;
     buildTarget(options: {
         sourceId?: string;
         sourceIdentity?: string;
@@ -16,41 +30,118 @@ export interface RebuildIntegration {
         platform: PlatformName;
         scope: Scope;
         cwd: string;
-        command: 'install' | 'upgrade' | 'reinstall' | 'cleanup' | 'uninstall';
+        command: 'install' | 'sync' | 'reinstall' | 'cleanup' | 'uninstall';
         catalog: CatalogResolution;
-        includeHistoricalLifecycleArtifacts: boolean;
         readOnlyInspectionPlan?: boolean;
+        readOnlyShallowInspectionPlan?: boolean;
+        includeNativeCleanupCandidate?: boolean;
+        removedPluginWhole?: boolean;
+        codexActivationCleanup?: Array<{
+            codexPluginId: string;
+            scope: Scope;
+            disposition: 'remove' | 'disable';
+        }>;
     }): Promise<DesiredTarget>;
 }
 export interface PreparedRebuildTarget {
     target: DesiredTarget;
-    driver: RebuildTargetDriver;
-    context: RebuildExecutionContext;
+}
+export declare class CodexActivationPostcheckError extends Error {
+    readonly code = "codexActivationPostcheckFailed";
+    readonly codexPluginIds: string[];
+    constructor(codexPluginIds: string | readonly string[], detail: string);
 }
 export interface RebuildExecutionContext {
     env: NodeJS.ProcessEnv;
     nativeCliRunner: NativeCliRunner;
+    codexManager?: CodexManager;
     reporter: CommandReporter;
     debugLogger: DebugLogger;
-    runtimeLeaseHeld?: boolean;
-    lifecycleLeaseHeld?: boolean;
     expectedCatalogConfigDigest?: string;
+    codexUserActivationDesired?: ReadonlySet<string>;
+    codexObservationSession?: CodexNativeObservationSession;
+    codexObservationScopeByMarketplace?: ReadonlyMap<string, 'user' | 'both'>;
+    preApplyExecutionCache?: Map<string, Promise<void>>;
+    managedCommandProducerCache?: Map<string, Promise<CommandProducerResult>>;
+    commandResults?: CommandProducerResult[];
+    managedCommandCandidates?: Map<string, ManagedCommandCandidate[]>;
 }
-export declare function applyCodexHookGroupsTransactionFile(hooksPath: string, update: (parsed: ReturnType<typeof parseCodexSharedHooksFile>) => CodexSharedHookGroup[] | null, testHooks?: {
-    beforeCommit?: () => Promise<void>;
-}): Promise<boolean>;
-export declare function discoverCodexNativeResidueNames(options: {
+export declare function executeCodexReconcileActivations(options: {
+    plans: readonly CodexReconcilePlan[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    manager?: CodexManager;
+    runner: NativeCliRunner;
+    observationSession?: CodexNativeObservationSession;
+    preflightCompleted?: boolean;
+    mutationMarketplaces?: Set<string>;
+    observationScopeByMarketplace?: ReadonlyMap<string, 'user' | 'both'>;
+}): Promise<void>;
+export declare function postcheckCodexReconcileActivations(options: {
+    plans: readonly CodexReconcilePlan[];
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    manager?: CodexManager;
+    runner: NativeCliRunner;
+    observationSession?: CodexNativeObservationSession;
+    observationScopeByMarketplace?: ReadonlyMap<string, 'user' | 'both'>;
+}): Promise<void>;
+export interface CodexSharedNativeLiveInspection {
+    sharedNative: CodexSharedNativeInspection;
+    expectedPayloadDigest?: string;
+}
+export interface CodexPluginRegistrationLiveInspection {
+    observation: CodexNativePluginObservation;
+    observations: {
+        user: boolean;
+        project: boolean;
+    };
+    activations: {
+        user?: boolean;
+        project?: boolean;
+    };
+}
+export declare function inspectCodexPluginRegistrationLive(options: {
+    pluginId: string;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    nativeCliRunner?: NativeCliRunner;
+    manager?: CodexManager;
+    scope?: 'user' | 'project' | 'both';
+    observationSession?: CodexNativeObservationSession;
+}): Promise<CodexPluginRegistrationLiveInspection>;
+export declare function removeCodexPluginActivation(options: {
+    configPath: string;
+    codexPluginId: string;
+}): Promise<void>;
+export declare function removeNamespacedMarketplacePluginProjection(options: {
+    rootDir: string;
+    sourceId: string;
+    sourceIdentity: string;
+    pluginName: string;
+    env: NodeJS.ProcessEnv;
+}): Promise<void>;
+/**
+ * Read-only shared-native inspection. Official Codex list evidence owns installation
+ * state. Filesystem validation is limited to the AW-owned marketplace source.
+ */
+export declare function inspectCodexSharedNativeLive(options: {
+    pluginName: string;
+    sourceId: string;
+    desiredVersion: string;
+    expectedPayloadDigest?: string;
+    inspectionMode?: 'shallow' | 'payload';
     cwd: string;
     env: NodeJS.ProcessEnv;
     marketplaceName?: string;
     marketplaceRoot?: string;
-}): Promise<string[]>;
-export declare class CodexNativeResidueProbeError extends Error {
-    readonly code = "codexNativeResidueProbeFailed";
-    readonly location: string;
-    readonly pluginName?: string;
-    constructor(location: string, cause: unknown, pluginName?: string);
-}
+    nativeCliRunner?: NativeCliRunner;
+    manager?: CodexManager;
+    observationScope?: 'user' | 'both';
+    observationSession?: CodexNativeObservationSession;
+    pluginRegistration?: CodexPluginRegistrationLiveInspection;
+    nativeRenderPlugin?: PluginMeta;
+}): Promise<CodexSharedNativeLiveInspection>;
 export declare function assertNoClaudeUnboundNativeNameCollision(options: {
     pluginName: string;
     cwd: string;
@@ -62,9 +153,37 @@ export declare function inspectNativeMarketplaceRegistrations(options: {
     cwd: string;
     env: NodeJS.ProcessEnv;
 }): Promise<Record<PlatformName, 'absent' | 'canonical' | 'foreign'>>;
+export interface ReviewNativeSkillSelection {
+    skill: string;
+    targetId: string | null;
+}
+export interface MaterializedReviewNativeSkills {
+    rootDir: string;
+    skills: Array<{
+        skill: string;
+        path: string;
+    }>;
+}
+/**
+ * Materialize only the selected Codex or Claude Skills into an isolated review root.
+ * The caller owns outputRoot and is responsible for its cleanup.
+ */
+export declare function materializeReviewNativeSkills(options: {
+    plugin: PluginMeta;
+    platform: 'codex' | 'claude';
+    scope: Scope;
+    cwd: string;
+    env: NodeJS.ProcessEnv;
+    outputRoot: string;
+    skills: readonly ReviewNativeSkillSelection[];
+    allowDisabledNativeSkills?: boolean;
+    scriptTimeoutMs?: number;
+}): Promise<MaterializedReviewNativeSkills>;
 export declare function createRebuildIntegration(options: {
     context: RebuildExecutionContext;
     scriptTimeoutMs?: number;
+    preparedTargets?: readonly DesiredTarget[];
+    operationScopedNativePhases?: boolean;
 }): RebuildIntegration;
 export declare function inspectRebuildTarget(options: {
     sourceId?: string;
@@ -78,6 +197,9 @@ export declare function inspectRebuildTarget(options: {
     cwd: string;
     catalog: CatalogResolution;
     context: RebuildExecutionContext;
+    userActivationDesired?: ReadonlySet<string>;
+    nativeProbe?: NativeOwnershipProbe;
+    shallow?: boolean;
 }): Promise<{
     target: DesiredTarget;
     inspection: OwnershipInspection;