import type { LinkMode } from './types.js';
/**
 * FS utilities (PR2 scope): atomic writes, dir hashing (fast mtime+size path + full sha),
 * cross platform notes. Minimal impl; expanded in later PRs (proper-lockfile etc).
 */
export declare function ensureDir(dir: string): Promise<void>;
/**
 * Atomic write: write to temp then rename.
 */
export declare function writeFileAtomic(filePath: string, data: string | Buffer): Promise<void>;
/**
 * Compute sha256 of a file (for single files).
 */
export declare function computeFileHash(filePath: string): Promise<string>;
/**
 * Recursive dir hash for skill canonical dir.
 * PR12 Performance: callers use getDirStatSignature + stored integrity (from lock/cache)
 * to fast-skip full re-hash when mtime/size/count unchanged (drift detection).
 * Only re-compute SHA on add --force or detected change. Cache uses integrity key.
 * Always full content hash for correctness of integrity value.
 */
export declare function computeDirIntegrity(dir: string): Promise<string>;
/** Accept pre-0.6.1 hashes produced with either native path separator. */
export declare function matchesDirIntegrity(dir: string, expected: string): Promise<boolean>;
/**
 * Fast stat based check (used for drift detection in doctor etc).
 */
export declare function getDirStatSignature(dir: string): Promise<{
    mtime: number;
    size: number;
    count: number;
}>;
export declare function getDefaultLinkMode(): LinkMode;
//# sourceMappingURL=fs.d.ts.map