/**
 * API surface scan service.
 *
 * Walks the project for CLI subcommands, service-level public exports,
 * public types, and module-level constants. Output feeds the tech-doc
 * "Existing API / Component Inventory" section. Read-only — no writes.
 *
 * Pattern follows `libraries-service.ts` (readFileSync + readdir; pure
 * data shape; no AST parsing). karpathy §2: minimum code, no abstractions.
 */
import type { ApiSurfaceOptions, ApiSurfaceReport, CliEntry, ConstantEntry, ServiceEntry, TypeEntry } from './api-surface-types.js';
export type { ApiSurfaceOptions, CliEntry, ServiceEntry, TypeEntry, ConstantEntry, ApiSurfaceReport };
/**
 * Scan the project for API surfaces. Read-only. Never throws; failures
 * surface as warnings in the report.
 */
export declare function scanApiSurface(options: ApiSurfaceOptions): Promise<ApiSurfaceReport>;
export declare function formatApiSurfaceMarkdown(report: ApiSurfaceReport, opts?: {
    maxPerKind?: number;
    truncatedCounts?: {
        cli: number;
        service: number;
        type: number;
        constant: number;
    };
}): string;