/**
 * Git-state signal (C1, 1.6.0).
 *
 * Lightweight read-only git context: current branch, short HEAD SHA, whether
 * the working tree is dirty, and the last few commit titles. Lets the
 * Context Engine ground prompts in "what the user is currently iterating
 * on" — e.g. branch=feat/auth-refactor + last-3 commits about auth signals
 * the engine more strongly than just the package.json frameworks list.
 *
 * Failure mode: silently returns undefined when cwd isn't a git repo, or
 * when git is not on PATH, or when any subcommand fails. This signal is
 * never load-bearing — its job is to enrich, not gate.
 */
export interface GitSignal {
    /** e.g. 'main', 'feat/auth-refactor'. May be undefined on detached HEAD. */
    branch?: string;
    /** 7-char short SHA of HEAD. */
    headShort?: string;
    /** true when working tree has unstaged or untracked changes. */
    dirty: boolean;
    /** Last N commit titles (oneline). Newest first. */
    recentCommits: string[];
}
export declare function collectGitSignal(cwd: string): GitSignal | undefined;