import type { IdeId } from '../ide/ide-types.js';
/**
 * The 8 platforms per Slice #12 final piece. Slice #0.7 + Slice
 * #0.5.2 registered these in the IdeId union; this list is the
 * single source of truth for the sync fan-out.
 */
export declare const SYNC_PLATFORMS: readonly IdeId[];
/**
 * What the canonical store holds for one skill, as the installer found it.
 *
 * `current` — the store holds this entry and it is not behind the installed
 * release. `stale` — it is behind, or its bytes differ from the package's.
 * `unmanaged` — the store holds an entry peaks-loop does not own (no
 * sidecar); it is never overwritten, and it is reported so the skip is not
 * silent. `retired` — the store holds an entry peaks-loop owns that this
 * release does not ship any more. `absent` — the store does not hold this
 * entry at all: there is nothing there to compare, so it is neither current
 * nor stale.
 */
export type StoreEntryState = 'current' | 'stale' | 'unmanaged' | 'retired' | 'absent';
export interface StoreEntryReport {
    readonly name: string;
    readonly state: StoreEntryState;
    /** What the installer did: `installed`, `unchanged`, `planned`, `unmanaged`. */
    readonly action: string;
    /** The version the copy was made from, or null when the marker records none. */
    readonly version: string | null;
    /** Why a stale entry was stale: `version` or `content`; null otherwise. */
    readonly reason: string | null;
}
export interface PlatformSyncResult {
    /** The platform that was attempted. */
    readonly platform: IdeId;
    /** True if installBundledSkills returned without error. */
    readonly ok: boolean;
    /** Skills newly symlinked (idempotent re-runs return []). */
    readonly installed: readonly string[];
    /** Skills whose target was not a managed symlink (third-party owned). */
    readonly skipped: readonly string[];
    /** What the canonical store holds per skill, as found. */
    readonly entries?: readonly StoreEntryReport[];
    /** Error message; present when ok=false. */
    readonly error?: string;
    /** Wall-clock duration in ms. */
    readonly durationMs: number;
}
export interface SyncServiceInput {
    readonly projectRoot: string;
    /** When omitted, the service iterates all 8 platforms. */
    readonly platforms?: readonly IdeId[] | undefined;
    /** When true, the installer is invoked in dry-run mode. */
    readonly dryRun?: boolean | undefined;
    /** Reconcile managed Junctions that point at deleted host worktrees. */
    readonly reconcileJunctions?: boolean | undefined;
}
export interface SyncServiceResult {
    readonly applied: boolean;
    readonly dryRun: boolean;
    readonly projectRoot: string;
    readonly perPlatform: readonly PlatformSyncResult[];
    readonly syncedCount: number;
    readonly failedCount: number;
    readonly totalInstalled: number;
}
export interface InstallBundledSkillsOptions {
    readonly ideId: IdeId;
    readonly projectRoot: string;
    readonly dryRun?: boolean;
    readonly reconcileJunctions?: boolean;
    readonly targetRoot?: string;
}
export interface InstallResult {
    readonly installed: readonly string[];
    readonly skipped: readonly string[];
    /** What the canonical store holds per skill, when the installer reports it. */
    readonly entries?: readonly StoreEntryReport[];
}
export type InstallerFn = (opts: InstallBundledSkillsOptions) => InstallResult;
/**
 * Test seam: attempt to import the installer at `scriptPath`.
 * Returns the `installBundledSkills` function on success, or
 * `null` when the file is missing / not importable. The
 * production code calls this through `loadInstaller`; tests
 * `vi.spyOn` it to drive the three-tier probe without touching
 * the real filesystem.
 */
export declare function loadInstallerForTest(scriptPath: string): Promise<InstallerFn | null>;
/**
 * Validate a single platform id against the SYNC_PLATFORMS
 * allowlist. Throws on a bogus value.
 */
export declare function assertValidPlatform(platform: string): asserts platform is IdeId;