export declare const ORIENTATION_SCHEMA: "humanish.orientation.v1";
export interface OrientationState {
    schema: typeof ORIENTATION_SCHEMA;
    /** Whether this project has a committed `humanish/` source plane. */
    initialized: boolean;
    /** Committed + gitignored lab manifests discovered in this project. */
    labCount: number;
    /** Ids of a few labs worth naming in a suggestion. */
    labIds: string[];
    /** Runs already on disk, and the most recent one if there is one. */
    runCount: number;
    latestRunId?: string;
    /** The commands that make sense from HERE, most useful first. */
    nextCommands: OrientationCommand[];
}
export interface OrientationCommand {
    command: string;
    why: string;
}
/**
 * Read the project's state. Pure-ish: it only reads, never writes, and never touches the network or
 * a provider — bare invocation must not be able to spend money or mutate a repo.
 */
export declare function readOrientation(cwd: string): Promise<OrientationState>;
/**
 * The human rendering. Says where you are before it says what to do, because "what should I run"
 * has no answer that is true in every project.
 */
export declare function formatOrientationHuman(state: OrientationState): string;