import type { ProjectKnowledgeDiagnostic, ProjectKnowledgeProvider, ProjectKnowledgeQuery } from './types.js';
export declare const CAPABILITY_ASSOCIATION_FILE = "capability-association.yaml";
export type WorkflowCapability = 'native' | 'classic';
export type CapabilityCandidateConfidence = 'high' | 'medium' | 'low';
export interface WorkflowCapabilityDiscoveryScope {
    readonly workflow: WorkflowCapability;
    /** Project-relative directory containing the current `spec.md` files. */
    readonly currentSpecRoot: string;
    /** Project-relative directory containing archived changes. */
    readonly archiveRoot: string;
}
export interface WorkflowCapabilityEvidence {
    readonly source: string;
    readonly kind: string;
    readonly title?: string;
    readonly snippet?: string;
}
export interface WorkflowCapabilityCandidate {
    readonly workflow: WorkflowCapability;
    readonly capability: string;
    readonly currentSpec: {
        readonly source: string;
        readonly hash: string;
    };
    readonly historicalSources: readonly string[];
    readonly matchedTerms: readonly string[];
    readonly confidence: CapabilityCandidateConfidence;
    readonly score: number;
    readonly reason: string;
    readonly evidence: readonly WorkflowCapabilityEvidence[];
}
export interface CapabilityAssociationDraft {
    readonly schema: 'comet.capability-association.v1';
    readonly status: 'suggested' | 'explicit';
    readonly workflow: WorkflowCapability;
    readonly capability: string;
    readonly current_spec: string;
    readonly current_hash: string;
    readonly confidence: CapabilityCandidateConfidence;
    readonly query?: string;
    readonly reason: string;
    readonly historical_sources: readonly string[];
    readonly evidence: readonly WorkflowCapabilityEvidence[];
}
export interface WorkflowCapabilityDiscoveryResult {
    readonly workflow: WorkflowCapability;
    readonly query: ProjectKnowledgeQuery | null;
    readonly candidates: readonly WorkflowCapabilityCandidate[];
    readonly associationDraft: CapabilityAssociationDraft | null;
    readonly diagnostics: readonly ProjectKnowledgeDiagnostic[];
    readonly searched: boolean;
    readonly providerLimit: number;
}
/** Parse and validate the persisted association draft before it contributes to Shape. */
export declare function parseCapabilityAssociationDraft(value: unknown): CapabilityAssociationDraft;
export declare function discoverWorkflowCapabilityCandidates(options: {
    readonly projectRoot: string;
    readonly scope: WorkflowCapabilityDiscoveryScope;
    readonly provider?: ProjectKnowledgeProvider;
    readonly task?: string;
    readonly capability?: string;
    readonly limit?: number;
}): Promise<WorkflowCapabilityDiscoveryResult>;
export declare function renderCapabilityAssociationDraft(draft: CapabilityAssociationDraft): string;
//# sourceMappingURL=capability-discovery.d.ts.map