/**
 * Guardrails Bridge — Mindkit guardrails within nexus-prime src/
 *
 * Provides GuardrailEngine directly within the src/ tree so mcp.ts
 * can import it without going outside rootDir. This mirrors the same
 * 6 rules from packages/mindkit/src/guardrails.ts.
 */
export type GuardrailSeverity = 'error' | 'warn' | 'info';
export interface GuardrailContext {
    action: string;
    tokenCount?: number;
    filesToModify?: string[];
    isDestructive?: boolean;
    stage?: 'pre-plan' | 'action';
    compiledActions?: string[];
}
export interface GuardrailViolation {
    id: string;
    severity: GuardrailSeverity;
    rule: string;
    detail: string;
    suggestion: string;
}
export interface GuardrailResult {
    passed: boolean;
    violations: GuardrailViolation[];
    warnings: GuardrailViolation[];
    score: number;
}
export declare class GuardrailEngine {
    private externalRules;
    private static _cachePath;
    private static get CACHE_PATH();
    check(ctx: GuardrailContext): GuardrailResult;
    format(result: GuardrailResult): string;
    listRules(): {
        id: string;
        rule: string;
        severity: GuardrailSeverity;
    }[];
    /**
     * Sync guardrail rules from the MindKit GitHub repo.
     * Fetches from sir-ad/mindkit, caches locally for 1 hour.
     * Falls back silently to bundled rules if offline.
     */
    syncFromGitHub(): Promise<{
        synced: boolean;
        ruleCount: number;
        source: string;
    }>;
    private loadExternalRules;
    /**
     * Bidirectional MindKit sync — push Nexus findings back to MindKit.
     * Writes evolution candidates, session learnings, and guardrail outcomes
     * to MindKit's memory/sessions directory via GitHub API.
     */
    pushFindingsToMindKit(findings: {
        sessionId: string;
        findings: string[];
        hotspots: Array<[string, number]>;
        recommendations: string[];
    }): Promise<{
        pushed: boolean;
        reason: string;
    }>;
}
