/**
 * Shared helper functions for CLI commands
 */
import type { ToolScoringOutput } from '@aiready/core';
/**
 * Warn if graph caps may be exceeded for visualization.
 *
 * @param report - The combined analysis report.
 * @param dirPath - Root directory to look for configuration.
 */
export declare function warnIfGraphCapExceeded(
  report: any,
  dirPath: string
): Promise<void>;
/**
 * Generate markdown report for consistency command.
 *
 * @param report - The consistency report object.
 * @param elapsedTime - Time taken for analysis in seconds.
 * @returns Formatted markdown string.
 */
export declare function generateMarkdownReport(
  report: any,
  elapsedTime: string
): string;
/**
 * Truncate array for display (show first N items with "... +N more").
 *
 * @param arr - The array to truncate.
 * @param cap - Maximum number of items to show before truncating.
 * @returns Formatted string for display.
 */
export declare function truncateArray(
  arr: any[] | undefined,
  cap?: number
): string;
/**
 * Build a common ToolScoringOutput payload from a tool report.
 *
 * @param toolName - Identifier for the tool.
 * @param report - Minimal report structure containing score and recommendations.
 * @returns Standardized scoring output.
 */
export declare function buildToolScoringOutput(
  toolName: string,
  report: {
    summary: {
      score: number;
    };
    rawData?: Record<string, unknown>;
    recommendations?: string[];
  }
): ToolScoringOutput;
/**
 * Load config and apply tool-level defaults.
 *
 * @param directory - Directory to search for config.
 * @param defaults - Tool-specific default values.
 * @returns Merged configuration with tool defaults.
 */
export declare function loadMergedToolConfig<T extends Record<string, unknown>>(
  directory: string,
  defaults: T
): Promise<T & Record<string, unknown>>;
/**
 * Shared base scan options used by CLI tool commands.
 *
 * @param directory - Root directory for scanning.
 * @param options - CLI commander options object.
 * @param extras - Additional tool-specific options.
 * @returns Combined scan options for the analyzer.
 */
export declare function buildCommonScanOptions(
  directory: string,
  options: any,
  extras?: Record<string, unknown>
): Record<string, unknown>;
/**
 * Execute a config-driven tool command with shared CLI plumbing.
 *
 * @param params - Execution parameters including analyze and score callbacks.
 * @returns Promise resolving to the tool report and its scoring output.
 */
export declare function runConfiguredToolCommand<TReport, TScoring>(params: {
  directory: string;
  options: any;
  defaults: Record<string, unknown>;
  analyze: (scanOptions: any) => Promise<TReport>;
  getExtras: (
    options: any,
    merged: Record<string, unknown>
  ) => Record<string, unknown>;
  score: (report: TReport) => TScoring;
}): Promise<{
  report: TReport;
  scoring: TScoring;
}>;
//# sourceMappingURL=helpers.d.ts.map