/** * Core platform-path façade — delegates to the `@cleocode/paths` SSoT. * * Historically core hand-rolled an `env-paths` wrapper here. That logic now * lives in `@cleocode/paths` and is shared with `@cleocode/worktree`, * `@cleocode/brain`, `@cleocode/adapters`, and `@cleocode/caamp`. This module * re-exposes the cleo-bound surface so existing core consumers * (`getPlatformPaths`, `getSystemInfo`, `getSystemPaths`, etc.) keep working * without code changes. * * Platform path defaults (no `CLEO_HOME` set): * data: ~/.local/share/cleo | ~/Library/Application Support/cleo | %LOCALAPPDATA%\cleo\Data * config: ~/.config/cleo | ~/Library/Preferences/cleo | %APPDATA%\cleo\Config * cache: ~/.cache/cleo | ~/Library/Caches/cleo | %LOCALAPPDATA%\cleo\Cache * log: ~/.local/state/cleo | ~/Library/Logs/cleo | %LOCALAPPDATA%\cleo\Log * temp: /tmp//cleo | /var/folders/.../cleo | %TEMP%\cleo * * `CLEO_HOME` env var overrides the data path (with tilde expansion). * * @task T1884 */ import { type PlatformPaths, type SystemInfo } from '@cleocode/paths'; export type { PlatformPaths, SystemInfo }; /** * Get OS-appropriate paths for CLEO's global directories. * * Delegates to {@link getCleoPlatformPaths} from `@cleocode/paths`. * Reads fresh on every call — env-paths is microsecond-fast. */ export declare function getPlatformPaths(): PlatformPaths; /** * Get a cached system information snapshot. * Captured once and reused for the process lifetime. */ export declare function getSystemInfo(): SystemInfo; /** * Invalidate the cached system info snapshot. * Use in tests that need a fresh platform snapshot. * @internal */ export declare function _resetPlatformPathsCache(): void; /** Summary of all resolved CleoOS paths (project + global hub). */ export interface PathsData { /** Project-local .cleo directory (absolute). */ projectCleoDir: string; /** XDG-compliant global data root (Linux: ~/.local/share/cleo). */ cleoHome: string; /** XDG config dir (Linux: ~/.config/cleo). */ configDir: string; /** CleoOS Hub subdirectories under cleoHome. */ hub: { globalRecipes: string; globalJustfile: string; piExtensions: string; cantWorkflows: string; globalAgents: string; }; /** Scaffolding status — true if hub directories + seed files exist. */ scaffolded: { globalRecipes: boolean; globalJustfile: boolean; piExtensions: boolean; cantWorkflows: boolean; globalAgents: boolean; }; } /** * Report all resolved CleoOS paths (project + global hub). * * Read-only: reports current state without mutating the filesystem. * Backs the `cleo admin paths` CLI command. * * @param projectRoot - Absolute path to the project root * @returns Aggregated path data for all CLEO directories * * @task T1571 */ export declare function getSystemPaths(projectRoot: string): PathsData; //# sourceMappingURL=platform-paths.d.ts.map