/**
 * v2.15.0 follow-up — G7: documentation auto-generator.
 *
 * Two CLI surfaces:
 *   1. `peaks doc generate-skill --from <code-path>` — produces a SKILL.md
 *      skeleton by scanning a code directory for command exports,
 *      with sections derived from JSDoc / signature.
 *   2. `peaks doc changelog-suggest --since <git-ref>` — diffs
 *      src/cli/commands/*.ts since the ref and emits a
 *      "## [Unreleased]" block describing the changes.
 *
 * Both are pragmatic / 80% solutions; the goal is to make the operator's
 * life easier, not to fully automate documentation.
 */
export interface SkillSection {
    readonly heading: string;
    readonly bullets: readonly string[];
}
export interface SkillDoc {
    readonly name: string;
    readonly description: string;
    readonly sections: readonly SkillSection[];
}
/** Generate a SKILL.md skeleton from a directory of CLI command files. */
export declare function generateSkillFromCommands(skillName: string, commandsDir: string): SkillDoc;
/** Render SkillDoc as markdown. */
export declare function renderSkillMarkdown(doc: SkillDoc): string;
export interface ChangelogEntry {
    readonly kind: 'feat' | 'fix' | 'docs' | 'refactor' | 'chore';
    readonly subject: string;
    readonly file: string;
}
/** Parse a single commit subject line into a ChangelogEntry. */
export declare function parseCommitSubject(subject: string, file: string): ChangelogEntry;
/** Run `git log` for the given ref range, return parsed entries. */
export declare function gitLogSince(projectRoot: string, since: string): ChangelogEntry[];
/** Group entries by kind + render a "## [Unreleased]" block. */
export declare function suggestChangelog(entries: readonly ChangelogEntry[]): string;