import type { CapabilityEffect } from "./types.js";
export type RepositoryMiningConfidence = "high" | "medium" | "low";
export type RepositoryEvidenceKind = "declaration" | "documentation" | "test" | "example" | "manifest" | "route" | "effect" | "dependency";
export type RepositoryCandidateKind = "function" | "class" | "cli" | "http-operation" | "library-export";
export type RepositoryEvidence = {
    kind: RepositoryEvidenceKind;
    path: string;
    line?: number;
    detail: string;
    strength: RepositoryMiningConfidence;
};
export type RepositoryEffectInference = {
    effect: CapabilityEffect;
    confidence: RepositoryMiningConfidence;
    evidence: readonly RepositoryEvidence[];
};
export type RepositoryCapabilityCandidate = {
    kind: RepositoryCandidateKind;
    candidateId: string;
    name: string;
    description: string;
    symbol?: string;
    language?: string;
    sourcePath: string;
    line?: number;
    signature?: string;
    confidence: {
        score: number;
        level: RepositoryMiningConfidence;
    };
    usefulnessScore: number;
    queryScore: number;
    evidence: readonly RepositoryEvidence[];
    effects: readonly RepositoryEffectInference[];
    authority: {
        complete: false;
        note: string;
    };
    executable: false;
    draftContract: {
        specVersion: "0.1";
        id: string;
        version: "0.0.0-inferred";
        name: string;
        description: string;
        effects: readonly CapabilityEffect[];
        metadata: Record<string, unknown>;
    };
};
export type RepositoryMiningReport = {
    repository: {
        fullName: string;
        url: string;
        description?: string;
        defaultBranch: string;
        ref: string;
        commit: string;
        language?: string;
        license?: string;
        archived: boolean;
    };
    packageHints: {
        npm?: {
            name: string;
            version?: string;
            bins: Readonly<Record<string, string>>;
        };
        openapiFiles: readonly string[];
        mcpSignals: readonly string[];
    };
    coverage: {
        treeTruncated: boolean;
        eligibleFiles: number;
        analyzedFiles: number;
        sourceEligible: number;
        sourceAnalyzed: number;
        sourceCoverageRatio: number;
        maxFiles: number;
        maxFileBytes: number;
    };
    candidates: readonly RepositoryCapabilityCandidate[];
    hazards: readonly string[];
    unsupportedExtensions: readonly string[];
    generatedAt: string;
};
export type RepositoryMiningOptions = {
    fetch?: typeof fetch;
    githubToken?: string;
    ref?: string;
    query?: string;
    maxFiles?: number;
    maxFileBytes?: number;
    maxCandidates?: number;
    signal?: AbortSignal;
};
export declare function mineGitHubRepository(locator: string, options?: RepositoryMiningOptions): Promise<RepositoryMiningReport>;
//# sourceMappingURL=repository-mine.d.ts.map