/**
 * Policy Seed Generator - Generate seed policy from Code Atlas data
 *
 * Part of Code Atlas Epic (CA-010) - Layer 4: Policy Integration (Stretch Goal)
 *
 * This generates a **seed** for human refinement, not a final policy.
 * The algorithm groups code units by directory prefix and infers module
 * boundaries from directory depth, unit density, and naming patterns.
 */
import type { CodeUnit } from "./schemas/code-unit.js";
import type { PolicySeed } from "./schemas/policy-seed.js";
/**
 * Options for policy seed generation
 */
export interface GeneratePolicySeedOptions {
    /** Minimum units per module (default: 3) */
    minUnitsPerModule?: number;
}
/**
 * Generate a policy seed from a list of code units
 *
 * Algorithm (v0, simple):
 * 1. Group code units by directory prefix
 * 2. Consolidate small directories into parents
 * 3. Count units per directory
 * 4. Infer module boundaries from:
 *    - Directory depth
 *    - Unit density
 *    - Naming patterns (test, spec, mock)
 * 5. Emit YAML-compatible seed with notes
 *
 * @param units - Array of discovered code units
 * @param repoId - Repository identifier
 * @param options - Generation options
 * @returns PolicySeed object
 */
export declare function generatePolicySeed(units: CodeUnit[], repoId: string, options?: GeneratePolicySeedOptions): PolicySeed;