Architecture

flowchart TD
    Start["Human feedback = docs direction approved plus CLI UX polish"]
    Verify["Verify current init picker and shared picker"]
    Current["Current Src option lacks recommended marker and shared picker lacks default ordering"]
    Polish["Add default flag and default-first ordering in picker"]
    Init["Mark src/{project_name} as recommended in turbine init layout picker"]
    Docs["Update first-run docs to describe true CLI behavior"]
    Done["Approval-ready plan"]

    Start --> Verify --> Current --> Polish --> Init --> Docs --> Done

sequenceDiagram
    participant User as User
    participant Init as turbine_init
    participant Picker as picker
    participant Session as PickerSession
    participant Docs as Docs

    User->>Init: run turbine init on TTY
    Init->>Picker: layout options with Src default
    Picker->>Picker: sort defaults first
    Picker->>Session: create session with Src first
    Session-->>User: show src project_name recommended
    User->>Docs: read first-run docs
    Docs-->>User: same init and src default story

classDiagram
    class Option {
        +str label
        +str description
        +T value
        +bool default
        +resolved_value()
    }

    class PickerSession {
        +list~Option~ opts
        +bool multi
        +list~int~ filtered
        +handle_enter()
    }

    class ProjectInitializationLayout {
        <<StrEnum>>
        SRC
        FLAT
    }

    class InitCommand {
        +pick_layout()
        +pick_datasource_type()
        +init()
    }

    InitCommand --> Option
    InitCommand --> ProjectInitializationLayout
    PickerSession --> Option