/**
 * `neotoma setup --activate` — context detection for activation.
 *
 * Promoted from install.md Phase 3 Step 0. Before preference selection,
 * detect whether the install directory is developer-oriented, personal,
 * or mixed, so the agent doesn't default to personal-file ingestion in
 * a directory full of git repos.
 *
 * Returns a structured report. The CLI handler renders it as JSON for agents
 * or a human-readable summary for interactive use, then asks the user to
 * confirm/override the detected context.
 */
export type ContextKind = "developer" | "personal" | "mixed" | "unknown";
export interface ActivationContextReport {
    cwd: string;
    /** Direct subdirectories that contain a `.git/` folder. */
    git_repos: string[];
    /** True when the install directory itself is a git repository. */
    cwd_is_git_repo: boolean;
    /** Personal-file signal folders that exist at the top level. */
    personal_signals: string[];
    /**
     * Best-guess context kind from the scan. Agents SHOULD still confirm with
     * the user; this is a suggestion, not a decision.
     */
    detected_context: ContextKind;
    /**
     * One-line human summary suitable for the surfacing block in install.md
     * Phase 3 Step 0.
     */
    summary_line: string;
    /**
     * The exact question install.md Phase 3 Step 0 asks the user once the scan
     * results have been surfaced.
     */
    followup_question: string;
}
/**
 * Scan the given directory and return the structured context report.
 * Pure function (modulo filesystem reads); no prompts, no writes.
 */
export declare function detectActivationContext(cwd: string): ActivationContextReport;
export interface RunActivateOptions {
    cwd?: string;
    /**
     * Override the detected context (used when the user has answered the
     * followup question). When provided, the report's `detected_context`
     * stays as the scan's best guess and the override appears as
     * `confirmed_context`.
     */
    context?: ContextKind;
}
export interface ActivateReport extends ActivationContextReport {
    /**
     * User's confirmed answer when --context was passed. Null when the agent
     * still needs to ask the followup question.
     */
    confirmed_context: ContextKind | null;
    /**
     * Branch the agent should take next, derived from `confirmed_context` or
     * `detected_context`. null when context is `unknown` AND no override was
     * supplied (the agent MUST ask the user).
     */
    next_branch: "personal_data_ingest" | "developer_repo_integration" | "mixed_developer_then_personal" | "ask_user" | null;
}
/**
 * Run the activation context-detection step. Pure: no prompts, no writes.
 * The CLI handler renders the report and asks the user the followup question
 * when `next_branch === "ask_user"`.
 */
export declare function runActivate(options?: RunActivateOptions): ActivateReport;
//# sourceMappingURL=activate.d.ts.map