sequenceDiagram
    actor Developer
    participant ForgeCLI
    participant GitUtils
    participant GitCommand as GitCommandRunner

    Developer->>ForgeCLI: run command requiring submodules_uninitialized
    ForgeCLI->>GitUtils: submodules_uninitialized()
    GitUtils->>GitUtils: has_missing_dependencies(empty_iterator)
    GitUtils->>GitCommand: cmd().args(["submodule", "status"])
    GitCommand-->>GitUtils: stdout
    GitUtils->>GitUtils: parse lines, check for '-' prefix
    GitUtils-->>ForgeCLI: bool (uninitialized_submodules)
    ForgeCLI-->>Developer: report based on uninitialized_submodules

sequenceDiagram
    actor User
    participant ForgeCLI
    participant LintArgs
    participant BuildArgs
    participant ProjectCompiler
    participant BuildUtils as BuildUtils_get_solar_sources
    participant Solar

    User->>ForgeCLI: forge lint
    ForgeCLI->>LintArgs: execute()
    LintArgs->>ProjectCompiler: compile(input_files)
    ProjectCompiler-->>LintArgs: ProjectCompileOutput
    LintArgs->>BuildUtils: get_solar_sources_from_compile_output(config, output, target_paths, ignored_paths)
    BuildUtils->>BuildUtils: collect target source_paths
    BuildUtils->>BuildUtils: traverse imports, skip is_ignored(path)
    BuildUtils-->>LintArgs: SolcVersionedInput (filtered sources)
    LintArgs->>Solar: run lint with SolcVersionedInput
    Solar-->>User: lint results

    User->>ForgeCLI: forge build
    ForgeCLI->>BuildArgs: execute()
    BuildArgs->>ProjectCompiler: compile(input_files)
    ProjectCompiler-->>BuildArgs: ProjectCompileOutput
    BuildArgs->>BuildUtils: get_solar_sources_from_compile_output(config, output, target_paths, ignored_paths=None)
    BuildUtils-->>BuildArgs: SolcVersionedInput
    BuildArgs->>Solar: optional Solar checks
    Solar-->>User: build diagnostics

classDiagram
    class BuildUtils {
        +get_solar_sources_from_compile_output(config: Config, output: ProjectCompileOutput, target_paths: Option~PathBuf[]~, ignored_paths: Option~PathBuf[]~) Result~SolcVersionedInput~
        +configure_pcx_from_compile_output(pcx: PcxConfig, config: Config, output: ProjectCompileOutput, target_paths: Option~PathBuf[]~) Result~()~
    }

    class LintArgs {
        +execute() Result~()~
        -ignored: Vec~PathBuf~
    }

    class BuildArgs {
        +execute() Result~()~
    }

    class ProjectCompiler {
        +new() ProjectCompiler
        +files(files: Vec~PathBuf~) ProjectCompiler
        +compile(project: Project) ProjectCompileOutput
    }

    class ProjectCompileOutput {
        +graph() DependencyGraph
    }

    class DependencyGraph {
        +imports(path: Path) Path[]
    }

    class SolcVersionedInput {
        +input: SolcInput
    }

    class SolcInput {
        +sources: HashMap~PathBuf, SourceUnit~
    }

    LintArgs --> BuildUtils : uses get_solar_sources_from_compile_output
    BuildArgs --> BuildUtils : uses get_solar_sources_from_compile_output
    BuildUtils --> ProjectCompileOutput : reads imports via graph()
    ProjectCompileOutput --> DependencyGraph : returns
    SolcVersionedInput --> SolcInput : contains