export declare function ensureForgeCliPathsReady(): void;
/** Test-only: reset the in-process migration guard. */
export declare function __resetMigrationGuardForTests(): void;
/** ~/.pi/forge-cli/ (or FORGE_CLI_HOME override) */
export declare function getForgeCliUserRoot(): string;
/** ~/.pi/forge-cli/config.json — L1 global routing config */
export declare function getGlobalConfigPath(): string;
/** ~/.pi/forge-cli/cache/ — probe + dismissal caches */
export declare function getUserCacheDir(): string;
/** ~/.pi/forge-cli/state/ — reserved for future state markers */
export declare function getUserStateDir(): string;
/** ~/.pi/forge-cli/.migrated-from-legacy — migrator idempotency marker */
export declare function getMigrationMarkerPath(): string;
/** ~/.pi/forge-cli/transcripts/ — central run-transcript archive root */
export declare function getTranscriptArchiveRoot(): string;
/** ~/.pi/forge-cli/transcripts/index.jsonl — append-only global run timeline */
export declare function getTranscriptIndexPath(): string;
/** ~/.pi/forge-cli/transcripts/projects.json — projectKey registry */
export declare function getTranscriptProjectsPath(): string;
/** ~/.pi/forge-cli/transcripts/<projectKey>/<entityId>/<runId>/ — one archived run */
export declare function getRunArchiveDir(projectKey: string, entityId: string, runId: string): string;
/** <cwd>/.pi/forge-cli/ */
export declare function getProjectForgeCliDir(cwd: string): string;
/** <cwd>/.pi/forge-cli/config.json */
export declare function getProjectConfigPath(cwd: string): string;
/** ~/.pi/agent/themes/ — pi loads bundled themes from here */
export declare function getPiAgentThemesDir(): string;
/** ~/.pi/agent/agents/ — pi's standard agent directory */
export declare function getPiAgentAgentsDir(): string;
export interface LegacyPaths {
    /** ~/.pi/agent/forge-cli/config.json — pre-v0.10.0 global config */
    globalConfig: string;
    /** ${XDG_CACHE_HOME:-~/.cache}/forgecli/ — pre-v0.10.0 cache dir */
    cacheDir: string;
}
export declare function getLegacyPaths(): LegacyPaths;
/**
 * Replace a leading $HOME prefix with `~` for display. Pure string op.
 * Mirrors the helper that previously lived inline in vendored subagent
 * code; centralizing here keeps it discoverable and lets future call
 * sites pick it up. Always uses the real os.homedir() — does NOT honor
 * FORGE_CLI_HOME, because display paths describe physical locations.
 */
export declare function shortenPath(p: string): string;