import type { CadenceState } from '@manehorizons/cadence-types';
/** What the CLI gathered about the current repo (impure layer fills this). */
export interface QuickstartContext {
    initialized: boolean;
    /** Present iff initialized and state was readable. */
    state?: CadenceState;
    /** Best-effort next free phase number (IDLE only). */
    nextPhaseHint?: number;
}
/** A suggested command for a newcomer, with a short note. */
export interface QuickstartMove {
    command: string;
    note: string;
}
/** One entry in the onboarding command map. */
export interface QuickstartMapEntry {
    name: string;
    note: string;
}
/** Structured orientation — rendered to text or JSON. */
export interface Quickstart {
    status: 'uninitialized' | 'initialized';
    header: string;
    /** Pre-init moves (init, tutorial). Empty when initialized. */
    nextMoves: QuickstartMove[];
    /**
     * Post-init next move — reused from `nextAction`, never re-derived.
     * Deliberately narrowed to `{command, reason}` (phase 206) rather than the
     * full `NextAction` return: `nextAction()` now also carries a ranked
     * `legalMoves[]` (phase 206 T1), which is `cadence next`'s surface, not
     * quickstart's — mirrors `services/progress.ts`'s identical narrowing, so
     * `quickstart --json`'s public contract doesn't silently grow a field.
     */
    next?: {
        command: string;
        reason: string;
    };
    /** Always-present map of the onboarding commands. */
    commandMap: QuickstartMapEntry[];
}
/**
 * Compute a state-aware orientation. Pure over its context: the impure CLI does
 * the I/O and passes the result in. Post-init, the "Next" is delegated to
 * `nextAction` so it stays identical to `cadence progress`.
 */
export declare function buildQuickstart(ctx: QuickstartContext): Quickstart;
//# sourceMappingURL=build.d.ts.map