export interface Feature {
    readonly id: string;
    readonly category: "functional" | "visual" | "performance" | "security" | "ux";
    readonly description: string;
    readonly priority: number;
    readonly steps: string[];
    passes: boolean;
    passedAt?: string;
    failureNotes?: string;
}
export interface FeatureRegistrySnapshot {
    version: number;
    createdAt: string;
    updatedAt: string;
    features: Feature[];
}
export interface FeatureRegistrySummary {
    total: number;
    passing: number;
    failing: number;
    byCategory: Record<string, {
        total: number;
        passing: number;
        failing: number;
    }>;
}
export type FeatureInit = Omit<Feature, "id" | "passes" | "passedAt">;
export declare class FeatureRegistry {
    private readonly filePath;
    private readonly lockPath;
    constructor(path: string);
    /**
     * Initializer agent calls this once to populate the registry.
     * Throws if the file already exists — prevents accidental overwrites.
     */
    initialize(features: FeatureInit[]): Promise<void>;
    /**
     * Returns the next feature to work on: highest-priority feature that
     * is not yet passing. Returns null when all features pass.
     */
    getNextFeature(): Promise<Feature | null>;
    /**
     * Returns all features in the registry.
     */
    getAll(): Promise<Feature[]>;
    /**
     * Returns a summary: total, passing, failing, by category.
     */
    getSummary(): Promise<FeatureRegistrySummary>;
    /**
     * The ONLY mutation a coding agent may call.
     * Throws FeatureRegistryMutationError if any immutable field differs.
     * Throws FeatureNotFoundError if the feature ID doesn't exist.
     */
    markResult(id: string, passes: boolean, failureNotes?: string): Promise<void>;
    /**
     * Returns full snapshot for serialization into handoff artifacts.
     */
    snapshot(): Promise<FeatureRegistrySnapshot>;
    /**
     * Validates that a proposed update does not mutate immutable fields.
     * Exported for testing — agents should not call this directly.
     */
    static validateMutation(existing: Feature, update: Partial<Feature>): void;
    private readSnapshot;
}
//# sourceMappingURL=FeatureRegistry.d.ts.map