import type { VisionDocument } from './analyzers/types.js';
export declare function loadVision(cwd?: string): VisionDocument | null;
export declare function saveVision(vision: VisionDocument, cwd?: string): void;
/** Render the vision as a tracked Markdown document.
 *  Output is intended to live alongside the project (e.g. docs/vision.md)
 *  so collaborators and agents have a tracked source of truth — see GH #305. */
export declare function renderVisionMarkdown(vision: VisionDocument): string;
/** Write the vision to a Markdown file at the given cwd-relative path.
 *  Creates parent directories as needed. Refuses paths that resolve outside
 *  the project root (absolute paths or `..` traversal) unless
 *  SLOPE_VISION_MD_ALLOW_ABS=1 is set — guards against accidental
 *  /etc/passwd-style escapes via --write-md=<path>. */
export declare function writeVisionMarkdown(vision: VisionDocument, mdPath: string, cwd?: string): string;
/** Create a new vision document with timestamps. Validates, saves, and returns it. */
export declare function createVision(fields: {
    purpose: string;
    priorities: string[];
    audience?: string;
    techDirection?: string;
    nonGoals?: string[];
}, cwd?: string): VisionDocument;
/** Update fields of an existing vision document. Preserves createdAt, bumps updatedAt. */
export declare function updateVision(fields: Partial<Omit<VisionDocument, 'createdAt' | 'updatedAt'>>, cwd?: string): VisionDocument;
export declare function validateVision(vision: unknown): string[];
//# sourceMappingURL=vision.d.ts.map