export interface AgentCommandCatalog {
    generatedAt: string;
    packageName: string;
    packageVersion: string;
    markdownCommands: Array<{
        id: string;
        trigger: string;
        docPath: string;
        description: string;
        relatedCliCommandIds: string[];
    }>;
    executionModes: Array<{
        id: string;
        platform: "any" | "windows" | "posix";
        commandPrefix: string;
        whenToUse: string;
    }>;
    preferredExecutionOrder: string[];
    cliCommands: Array<{
        id: string;
        command: string;
        description: string;
        phase?: "setup" | "operate" | "maintain" | "advanced";
        primaryInPhase?: boolean;
    }>;
    agentSafeCliCommands: Array<{
        id: string;
        description: string;
        variants: Array<{
            modeId: string;
            command: string;
        }>;
    }>;
    npmScripts: Record<string, string>;
    recommendedAgentCommands: string[];
    recursiveEscalationHeuristics?: {
        advisoryOnly: boolean;
        triggers: string[];
        preferredSequence: string[];
        operatorHintCommand: string;
    };
}
export declare function loadAgentCommandCatalog(packageRoot: string): Promise<AgentCommandCatalog>;
export declare function writeAgentCommandCatalog(workspaceRoot: string, packageRoot: string): Promise<{
    jsonPath: string;
    markdownPath: string;
}>;
//# sourceMappingURL=command-catalog.d.ts.map