import type { ConfigOverrides } from "../config.js";
import { type RepositorySnapshot } from "../repository-evidence.js";
import { type DeclaredSkillRoute, type SkillDiscoveryAdoption, type SkillDiscoveryCoverage, type SkillDiscoveryDiagnostic, type SkillDiscoverySummary, type VisibleSkillIdentity } from "../skill-discovery.js";
import type { Diagnostic } from "../types/diagnostics.js";
export declare const SKILL_INDEX_SCHEMA_VERSION: "renma.skill-index.v1";
type SkillIndexFormat = "json" | "markdown";
/** Canonical complete or exactly focused static Skill Index report. */
interface SkillIndexReportV1 {
    schemaVersion: typeof SKILL_INDEX_SCHEMA_VERSION;
    root: string;
    configPath?: string;
    scannedFileCount: number;
    focus?: {
        id: string;
        sourcePath: string;
    };
    adoption: SkillDiscoveryAdoption;
    coverage: SkillDiscoveryCoverage;
    summary: SkillDiscoverySummary;
    skills: VisibleSkillIdentity[];
    routes: DeclaredSkillRoute[];
    publishedEntrypointIds: string[];
    reachableDiscoveryEligibleSkillIds: string[];
    notReachedDiscoveryEligibleSkillIds: string[];
    structuralRootIds: string[];
    standaloneSkillIds: string[];
    unroutedSkillIds: string[];
    diagnostics: {
        repository: Diagnostic[];
        discovery: SkillDiscoveryDiagnostic[];
    };
}
export declare function runSkillIndexCommand(targetPath: string, options: {
    format: SkillIndexFormat;
    focus?: string;
    overrides?: ConfigOverrides;
}): Promise<number>;
/** Build the report from one already prepared repository snapshot. */
export declare function buildSkillIndexReport(snapshot: RepositorySnapshot, focus?: string): SkillIndexReportV1;
export declare function formatSkillIndexJson(report: SkillIndexReportV1): string;
export declare function formatSkillIndexMarkdown(report: SkillIndexReportV1): string;
export {};