import type { FafData } from '../core/types.js';
/**
 * Render `.github/copilot-instructions.md` content from .faf data.
 *
 * GitHub Copilot's repository-wide custom-instructions file — the WIDEST-supported
 * instruction surface (web chat, code review, VS Code, JetBrains, Visual Studio,
 * Eclipse, Xcode, Copilot CLI, coding agent), injected into EVERY request.
 *
 * Built to GitHub's published custom-instructions guidance:
 * short, self-contained, imperative INSTRUCTIONS — not a metadata dump. So we lead
 * with the goal as a prose overview, Title-Case labels (acronym-aware), surface the
 * build/run steps as copy-pasteable commands, keep it compact, and avoid every named
 * anti-pattern (no tone/length rules, no external references). Deliberately NOT a
 * clone of AGENTS.md (which it outranks in-repo) — they are complementary.
 *
 * Strictly faithful to the .faf — nothing invented (GitHub bans speculative,
 * task-specific instructions). Future-proof: the command section + Title-Caser
 * already consume the richer slots Option B will add (test/lint/run, …), so this
 * emitter is built once and grows with the data.
 */
export declare function renderCopilotInstructions(data: FafData): string;
/**
 * Write `.github/copilot-instructions.md` — non-destructive (injects/updates the
 * faf block, preserves the rest). Creates the `.github/` directory if absent.
 * The project folder is the boundary: a `.github` linked outside it is refused.
 */
export declare function writeCopilotInstructions(dir: string, data: FafData): void;