export declare const UPDATE_IN_PROGRESS_ENV = "KLAW_UPDATE_IN_PROGRESS";
export declare const UPDATE_POST_CORE_CONVERGENCE_ENV = "KLAW_UPDATE_POST_CORE_CONVERGENCE";
export declare const UPDATE_DEFER_CONFIGURED_PLUGIN_INSTALL_REPAIR_ENV = "KLAW_UPDATE_DEFER_CONFIGURED_PLUGIN_INSTALL_REPAIR";
export declare const UPDATE_PARENT_SUPPORTS_DOCTOR_CONFIG_WRITE_ENV = "KLAW_UPDATE_PARENT_SUPPORTS_DOCTOR_CONFIG_WRITE";
/**
 * True iff the caller is the doctor pass that runs WHILE the core package
 * files are actively being swapped (e.g. inside `runGlobalPackageUpdateSteps`'
 * `postVerifyStep`). At this moment npm/pnpm machinery is busy and we must
 * NOT trigger fresh plugin installs that race with the in-flight package
 * manager activity. Configured plugin repair is deferred to the post-core
 * convergence pass.
 *
 * If post-core convergence is also set, treat the call as post-core
 * convergence (post-core wins). This lets a parent process re-enter doctor
 * with both flags set and still get repair behavior.
 *
 * NOTE: only consumers that route through this helper observe the
 * "post-core wins" semantics. Files that still read
 * `KLAW_UPDATE_IN_PROGRESS` directly (`commands/doctor-update.ts`,
 * `commands/doctor-repair-mode.ts`, `commands/doctor.e2e-harness.ts`,
 * `flows/doctor-health-contributions.ts`) treat both flags as
 * "update-in-progress". This is intentional: those paths are control-flow
 * gates (skip warnings, skip checks, e2e shims) where update-in-progress
 * suppression is still the correct behavior even mid-convergence. Migrate
 * a direct reader only when its semantics genuinely diverge between the
 * two phases.
 */
export declare function isUpdatePackageSwapInProgress(env: NodeJS.ProcessEnv): boolean;
/**
 * True iff configured plugin install repair should be deferred because the
 * updater guarantees a later post-core convergence pass. Shipped writable
 * parents predate the explicit defer marker but still resume after the
 * candidate doctor exits, so the candidate pass must not install payloads
 * that the parent will immediately repair again from stale in-memory records.
 */
export declare function shouldDeferConfiguredPluginInstallRepair(env: NodeJS.ProcessEnv): boolean;
/**
 * True iff a new doctor is running inside a shipped parent that can persist
 * doctor config repairs. Config writes must stay old-parent-readable because
 * that parent resumes after the candidate doctor exits. Modern parents also
 * set the explicit deferral marker, so they should keep current metadata
 * writes while still deferring payload repair.
 */
export declare function isLegacyParentWritableUpdateDoctorPass(env: NodeJS.ProcessEnv): boolean;
/**
 * True iff this newer doctor is running under an older updater. Legacy
 * updaters set only `KLAW_UPDATE_IN_PROGRESS`; they do not opt into the
 * post-core convergence pass, so configured plugin repair must happen now.
 */
export declare function isLegacyPackageUpdateDoctorPass(env: NodeJS.ProcessEnv): boolean;
/**
 * True iff we are running the post-core convergence pass: the core package
 * swap is done, the gateway has not been restarted yet, and configured plugin
 * repair MUST run before we hand control back for the restart.
 */
export declare function isPostCoreConvergencePass(env: NodeJS.ProcessEnv): boolean;