/**
 * Global (~/.cleo) home scaffolding: directory structure, stale-entry
 * cleanup, CleoOS hub template seeding, and the top-level
 * ensureGlobalScaffold orchestrator.
 */
import type { ScaffoldResult } from '@cleocode/contracts/scaffold-diagnostics';
/**
 * Required subdirectories under the global ~/.cleo/ home.
 */
export declare const REQUIRED_GLOBAL_SUBDIRS: readonly ["logs", "templates", "global-recipes", "pi-extensions", "cant-workflows", "agents"];
/**
 * Stale entries that must NOT exist at the global ~/.cleo/ level.
 */
export declare const STALE_GLOBAL_ENTRIES: readonly ["adrs", "rcasd", "agent-outputs", "backups", "sandbox", "tasks.db", "tasks.db-shm", "tasks.db-wal", "brain-worker.pid", "VERSION", "schemas", "bin", ".install-state", "templates/templates"];
/**
 * Result of scaffolding the CleoOS Hub.
 *
 * @task T1571
 */
export interface ScaffoldHubData {
    /** What action was taken on the hub. */
    action: 'created' | 'repaired' | 'skipped';
    /** Absolute path to the hub root. */
    path: string;
    /** Optional detail message. */
    details?: string;
}
/**
 * Ensure the global ~/.cleo/ home directory and its required
 * subdirectories exist. Idempotent.
 *
 * @returns Scaffold result indicating the action taken
 */
export declare function ensureGlobalHome(): Promise<ScaffoldResult>;
/**
 * Ensure the CleoOS Hub subdirectories exist under the global CLEO home
 * and seed all bundled hub templates if they are not already present.
 *
 * Idempotent: re-running is safe and will never overwrite a file that
 * already exists.
 *
 * @returns Scaffold result for the CleoOS hub root
 */
export declare function ensureCleoOsHub(): Promise<ScaffoldResult>;
/**
 * Perform a complete global scaffold operation: home + templates + CleoOS hub.
 *
 * @returns Combined scaffold results
 */
export declare function ensureGlobalScaffold(): Promise<{
    home: ScaffoldResult;
    templates: ScaffoldResult;
    cleoosHub: ScaffoldResult;
}>;
//# sourceMappingURL=global-scaffold.d.ts.map