type MoonforgeError derive(
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum AuditCode {
  DuplicateOutput
  OverlappingOutput
  MissingInput
  EmptyCommand
  UnreachableTask
  PhonyTaskInfo
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct AuditFinding {
  severity : AuditSeverity
  code : AuditCode
  task : String
  related_task : String?
  path : String?
  message : String
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct AuditReport {
  stats : ProjectStats
  findings : Array[AuditFinding]
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum AuditSeverity {
  Error
  Warning
  Info
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum BenchmarkShape {
  Chain
  Mixed
  Fanout
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct BenchmarkSpec {
  name : String
  task_count : Int
  depth : Int
  fanout : Int
  shape : BenchmarkShape
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct CacheEntry {
  command_hash : String
  input_hash : String
  output_hash : String
  duration_ms : Int
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub struct CacheSnapshot {
  version : Int
  tasks : Map[String, CacheEntry]
} derive(Eq, ToJson, 
@moonbitlang/core/debug.Debug
Debug, 
@moonbitlang/core/json.FromJson
FromJson)

pub(all) enum CliCommand {
  Help
  List(config_path~ : String)
  Graph(config_path~ : String, target~ : String?)
  Explain(config_path~ : String, target~ : String?)
  Stats(config_path~ : String)
  Audit(config_path~ : String)
  Clean(config_path~ : String)
  Doctor(config_path~ : String)
  Run(config_path~ : String, target~ : String?, jobs~ : Int)
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub(all) enum PlanReason {
  FirstRun
  PhonyTask
  CommandChanged
  InputsChanged
  OutputMissing
  OutputsChanged
  DependencyReran(Array[String])
  UpToDate
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct Project {
  root : String
  config_path : String
  tasks : Map[String, Task]
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct ProjectStats {
  default_target : String
  total_tasks : Int
  root_tasks : Int
  leaf_tasks : Int
  phony_tasks : Int
  concrete_tasks : Int
  tasks_with_inputs : Int
  tasks_with_outputs : Int
  total_declared_inputs : Int
  total_declared_outputs : Int
  max_depth : Int
  duplicate_outputs : Int
  overlapping_outputs : Int
  missing_inputs : Int
  unreachable_tasks : Int
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct RunMetrics {
  total_tasks : Int
  executed_tasks : Int
  skipped_tasks : Int
  total_duration_ms : Int
  average_duration_ms : Int
  cache_hit_percent : Int
  longest_task : String?
  longest_duration_ms : Int
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct RunSummary {
  plans : Array[TaskPlan]
  executed : Array[String]
  skipped : Array[String]
  durations_ms : Map[String, Int]
} derive(
@moonbitlang/core/debug.Debug
Debug)

pub struct Task {
  name : String
  cmd : String
  deps : Array[String]
  inputs : Array[String]
  outputs : Array[String]
  phony : Bool
  desc : String?
} derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

pub struct TaskPlan {
  task : Task
  reason : PlanReason
  should_run : Bool
  command_hash : String
  input_hash : String
} derive(
@moonbitlang/core/debug.Debug
Debug)

type VisitState derive(Eq, 
@moonbitlang/core/debug.Debug
Debug)

fn audit_code_label(code : AuditCode) -> String

fn audit_project(project : Project) -> AuditReport raise MoonforgeError

fn audit_severity_label(severity : AuditSeverity) -> String

fn audit_status(report : AuditReport) -> String

fn benchmark_description(spec : BenchmarkSpec) -> String

fn benchmark_specs() -> Array[BenchmarkSpec]

fn build_benchmark_project(spec : BenchmarkSpec) -> Project

fn clean_project(project : Project) -> Array[String] raise MoonforgeError

fn doctor(project : Project) -> Array[String] raise MoonforgeError

fn duplicate_outputs(project : Project) -> Array[(String, String, String)]

fn empty_cache() -> CacheSnapshot

fn explain_task(project : Project, target : String?) -> Array[String] raise MoonforgeError

fn help_text() -> String

fn list_tasks(project : Project) -> Array[String]

fn load_cache(project : Project) -> CacheSnapshot raise MoonforgeError

fn load_project(root? : String, config_path? : String) -> Project raise MoonforgeError

fn make_plan(project : Project, cache : CacheSnapshot, target : String?) -> (Array[String], Array[Array[String]], Array[TaskPlan]) raise MoonforgeError

fn metrics_csv_header() -> String

fn metrics_csv_row(summary : RunSummary) -> String

fn parse_cli(args : Array[String]) -> CliCommand raise MoonforgeError

fn plan_for_task(plans : Array[TaskPlan], task_name : String) -> TaskPlan?

fn project_stats(project : Project) -> ProjectStats raise MoonforgeError

fn reason_message(reason : PlanReason) -> String

fn render_audit_report(project : Project) -> Array[String] raise MoonforgeError

fn render_graph(project : Project, target : String?) -> Array[String] raise MoonforgeError

fn render_project_stats(project : Project) -> Array[String] raise MoonforgeError

fn render_run_metrics(summary : RunSummary) -> Array[String]

fn run_metrics(summary : RunSummary) -> RunMetrics

async fn run_target(project : Project, target : String?, jobs? : Int) -> RunSummary raise MoonforgeError

fn save_cache(project : Project, snapshot : CacheSnapshot) -> Unit raise MoonforgeError

fn task_levels(project : Project, order : Array[String]) -> Array[Array[String]] raise MoonforgeError

fn task_order(project : Project, target : String?) -> Array[String] raise MoonforgeError

fn task_summary_line(plan : TaskPlan) -> String

fn validate_project(project : Project) -> Unit raise MoonforgeError