/**
 * activate/state — activation state inspection: diff and explain (#435).
 *
 * Extracted from activate.ts: the read-only activation state surfaces
 * (diff between current/previous manifests, per-asset explain with truthful
 * reason strings) plus the shared CLI option parsers and set-diff helpers.
 * Activation materialization (host/rollback/reset) stays in activate.ts.
 */
import type { HostTarget } from "../types.js";
import { type ActivationHost } from "./selection.js";
/**
 * File name of the current activation manifest per host runtime root.
 */
export declare const ACTIVATION_MANIFEST_FILE = "activation-manifest.json";
/**
 * File name of the previous activation manifest snapshot used for diffs.
 */
export declare const ACTIVATION_PREVIOUS_MANIFEST_FILE = "activation-manifest.previous.json";
/**
 * Prints an activation diff between the current and previous manifests for
 * every affected host (or a single requested host).
 */
export declare function diffActivationState(projectRoot: string, args: string[]): Promise<void>;
/**
 * Prints a truthful per-host explanation of an asset's activation state:
 * whether it is active, its generation/budget context, and the concrete
 * reason (recommendation order, staged-bundle breadth, or legacy negative
 * score) behind that state (#426).
 */
export declare function explainActivationState(projectRoot: string, args: string[]): Promise<void>;
/**
 * Removes the entire activation output tree for a project root.
 */
export declare function resetActivationState(projectRoot: string): Promise<void>;
/**
 * Returns the value of an optional CLI option, or undefined when absent.
 */
export declare function getOptionalOptionValue(args: string[], optionName: string): string | undefined;
/**
 * Validates a raw CLI value against every registered recommendation host id.
 */
export declare function parseHostTargetOption(value: string | undefined, optionName: string): HostTarget | undefined;
/**
 * Returns the deduplicated list of every valid host target: the shared
 * target plus every registered adapter's recommendation host.
 */
export declare function getHostTargets(): HostTarget[];
/**
 * Validates a raw CLI value against activation-capable lifecycle host ids.
 */
export declare function parseActivationHostOption(value: string | undefined, optionName: string): ActivationHost | undefined;
/**
 * Returns whether a host target can be directly materialized by activation.
 */
export declare function isActivationHost(value: HostTarget): value is ActivationHost;
/**
 * Computes the added/removed string diff between two arrays, treating each
 * as a set, with both results sorted.
 */
export declare function diffStringSets(left: string[], right: string[]): {
    added: string[];
    removed: string[];
};
/**
 * Formats a diff list for display, using "none" for empty lists.
 */
export declare function formatDiffList(values: string[]): string;