export type InstructionFileSnapshot = {
    text: string;
    exists: boolean;
};
export type WriteInstructionFileResult = {
    filePath: string;
    backupPath?: string;
};
export type RemoveInstructionFileResult = {
    filePath: string;
    removed: boolean;
};
export type GuidanceIssueCheck = {
    requiredText: string;
    missingIssue: string;
};
export type ForbiddenGuidanceCheck = {
    forbiddenText: string;
    presentIssue: string;
};
export type GuidanceIssueOptions = {
    required: GuidanceIssueCheck[];
    forbidden?: ForbiddenGuidanceCheck[];
};
export declare function readInstructionFile(filePath: string): Promise<InstructionFileSnapshot>;
export declare function writeInstructionFile(filePath: string, text: string): Promise<WriteInstructionFileResult>;
export declare function removeInstructionFile(filePath: string): Promise<RemoveInstructionFileResult>;
export declare function collectGuidanceIssues(text: string, options: GuidanceIssueOptions): string[];