/**
 * olam kg status [<workspace>] — operator-facing report for KG storage.
 *
 * Phase C1 of olam-kg-service (plan ~/.claude/plans/olam-kg-service.md).
 *
 * Two modes:
 *   - `olam kg status` — enumerate every pristine + total overlay count.
 *     Compact table with built_at / node_count / size / world_count.
 *   - `olam kg status <workspace>` — same workspace's pristine plus a
 *     per-world overlay table (world_id / overlay-graphify-out size /
 *     overlay graph.json node_count).
 *
 * Storage layout (per Phase A2 + B1):
 *   - Pristines:  `~/.olam/kg/<workspace>/graphify-out/`  + `freshness.json`
 *   - Overlays:   `~/.olam/worlds/<world-id>/<clone-dir>/graphify-out/`
 *
 * Cumulative-storage policy (per tracker T1):
 *   - >= 1.5GB  → soft warn on stderr (operator decides whether to prune)
 *   - >= 5.0GB  → hard error on stderr + non-zero exit
 *
 * Risk T7 mitigation: workspace name (when passed) regex-validated via
 * @olam/core's `validateWorkspaceName`. All resolved paths asserted to
 * live under `~/.olam/` (via `kgPristinePath` / explicit prefix check).
 *
 * Side effects: read-only (no FS writes; no subprocess spawns).
 */
import type { Command } from 'commander';
interface KgStatusOptions {
    readonly json?: boolean;
}
interface PristineRecord {
    readonly workspace: string;
    readonly built_at: string | null;
    readonly node_count: number | null;
    readonly graphify_version: string | null;
    readonly graphify_out_size_bytes: number;
    readonly world_count: number;
}
interface OverlayRecord {
    readonly world_id: string;
    readonly clone_dir: string;
    readonly graphify_out_path: string;
    readonly graphify_out_size_bytes: number;
    readonly node_count: number | null;
}
interface KgStatusReport {
    readonly pristines: ReadonlyArray<PristineRecord>;
    readonly overlays: ReadonlyArray<OverlayRecord>;
    readonly total_bytes: number;
    readonly cap_status: 'ok' | 'soft-warn' | 'hard-critical';
}
interface RunResult {
    readonly exitCode: number;
    readonly report: KgStatusReport;
}
export declare function runKgStatus(workspaceArg: string | undefined, opts: KgStatusOptions): Promise<RunResult>;
export declare function registerKgStatusCommand(kg: Command): void;
export {};
//# sourceMappingURL=kg-status.d.ts.map