cmd
→
README
E
MoonforgeError
T
AuditCode
T
AuditFinding
T
AuditReport
T
AuditSeverity
T
BenchmarkShape
T
BenchmarkSpec
T
CacheEntry
T
CacheSnapshot
T
CliCommand
T
PlanReason
T
Project
T
ProjectStats
T
RunMetrics
T
RunSummary
T
Task
- ::is_effectively_phonyTask::is_effectively_phony
T
TaskPlan
T
VisitState
V
audit_code_label
V
audit_project
V
audit_severity_label
V
audit_status
V
benchmark_description
V
benchmark_specs
V
build_benchmark_project
V
clean_project
V
doctor
V
duplicate_outputs
V
empty_cache
V
explain_task
V
help_text
V
list_tasks
V
load_cache
V
load_project
V
make_plan
V
metrics_csv_header
V
metrics_csv_row
V
parse_cli
V
plan_for_task
V
project_stats
V
reason_message
V
render_audit_report
V
render_graph
V
render_project_stats
V
render_run_metrics
V
run_metrics
V
run_target
V
save_cache
V
task_levels
V
task_order
V
task_summary_line
V
validate_project

moonforge

A MoonBit-native incremental task runner for small builds, codegen workflows, and local CI orchestration.

moonbit

build-tool

task-runner

incremental-build

moon add Lyhdsba/moonforge@0.1.3

Download zip

Author

Lyhdsba

Version

0.1.3

License

Apache-2.0

Repository

github.com/Lyhdsba/MoonForge

Last updated

6 days ago

Downloads

Dependencies

README

#MoonForge

MoonForge is a MoonBit-native incremental task runner for small builds, code generation pipelines, document workflows, asset preparation, and local CI.

#Highlights

Declarative Moonforge.toml task configuration.
Dependency graph validation and cycle detection.
Input/output fingerprinting with .moonforge/cache.json.
run, list, graph, explain, stats, audit, clean, and doctor commands.
Bounded parallel execution by dependency level with -j N.

#Quick start

moon update
moon check --fmt --deny-warn --target native
moon fmt --check
moon info
moon test --deny-warn --target native
moon run --target native cmd/main -- stats
moon run --target native cmd/main -- audit

#Configuration example

[tasks.bundle]
cmd = 'python -c "print(\"bundle\")"'
deps = ["generate"]
inputs = ["src/schema.json"]
outputs = ["dist/bundle.txt"]
phony = false
desc = "Build the bundle"

Supported fields are cmd, deps, inputs, outputs, phony, and desc. Tasks without outputs are treated as effectively phony.

#CLI

moonforge list [--file PATH]
moonforge graph [TASK] [--file PATH]
moonforge explain [TASK] [--file PATH]
moonforge stats [--file PATH]
moonforge audit [--file PATH]
moonforge clean [--file PATH]
moonforge doctor [--file PATH]
moonforge run [TASK] [--file PATH] [-j N]

#
MoonforgeError

source

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

#
AuditCode

source

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

#
AuditFinding

source

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

#
AuditReport

source

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

#
AuditSeverity

source

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

#
BenchmarkShape

source

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

#
BenchmarkSpec

source

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

#
CacheEntry

source

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)

#
CacheSnapshot

source

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

#
CliCommand

source

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)

#
PlanReason

source

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

#
Project

source

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

#
ProjectStats

source

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)

#
RunMetrics

source

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)

#
RunSummary

source

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

#
Task

source

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)

#
Task::is_effectively_phony

source

fn Task::is_effectively_phony(self : Task) -> Bool

#
TaskPlan

source

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

#
VisitState

source

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

#
audit_code_label

source

fn audit_code_label(code : AuditCode) -> String

#
audit_project

source

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

#
audit_severity_label

source

fn audit_severity_label(severity : AuditSeverity) -> String

#
audit_status

source

fn audit_status(report : AuditReport) -> String

#
benchmark_description

source

fn benchmark_description(spec : BenchmarkSpec) -> String

#
benchmark_specs

source

fn benchmark_specs() -> Array[BenchmarkSpec]

#
build_benchmark_project

source

fn build_benchmark_project(spec : BenchmarkSpec) -> Project

#
clean_project

source

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

#
doctor

source

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

#
duplicate_outputs

source

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

#
empty_cache

source

fn empty_cache() -> CacheSnapshot

#
explain_task

source

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

#
help_text

source

fn help_text() -> String

#
list_tasks

source

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

#
load_cache

source

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

#
load_project

source

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

#
make_plan

source

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

#
metrics_csv_header

source

fn metrics_csv_header() -> String

#
metrics_csv_row

source

fn metrics_csv_row(summary : RunSummary) -> String

#
parse_cli

source

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

#
plan_for_task

source

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

#
project_stats

source

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

#
reason_message

source

fn reason_message(reason : PlanReason) -> String

#
render_audit_report

source

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

#
render_graph

source

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

#
render_project_stats

source

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

#
render_run_metrics

source

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

#
run_metrics

source

fn run_metrics(summary : RunSummary) -> RunMetrics

#
run_target

source

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

#
save_cache

source

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

#
task_levels

source

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

#
task_order

source

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

#
task_summary_line

source

fn task_summary_line(plan : TaskPlan) -> String

#
validate_project

source

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

Source Files

Site source Report issue Packages Build queue Skills Statistics

moonforge

#MoonForge

#Highlights

#Quick start

#Configuration example

#CLI

#MoonforgeError

#AuditCode

#AuditFinding

#AuditReport

#AuditSeverity

#BenchmarkShape

#BenchmarkSpec

#CacheEntry

#CacheSnapshot

#CliCommand

#PlanReason

#Project

#ProjectStats

#RunMetrics

#RunSummary

#Task

#Task::is_effectively_phony

#TaskPlan

#VisitState

#audit_code_label

#audit_project

#audit_severity_label

#audit_status

#benchmark_description

#benchmark_specs

#build_benchmark_project

#clean_project

#doctor

#duplicate_outputs

#empty_cache

#explain_task

#help_text

#list_tasks

#load_cache

#load_project

#make_plan

#metrics_csv_header

#metrics_csv_row

#parse_cli

#plan_for_task

#project_stats

#reason_message

#render_audit_report

#render_graph

#render_project_stats

#render_run_metrics

#run_metrics

#run_target

#save_cache

#task_levels

#task_order

#task_summary_line

#validate_project

Source Files

#
MoonforgeError

#
AuditCode

#
AuditFinding

#
AuditReport

#
AuditSeverity

#
BenchmarkShape

#
BenchmarkSpec

#
CacheEntry

#
CacheSnapshot

#
CliCommand

#
PlanReason

#
Project

#
ProjectStats

#
RunMetrics

#
RunSummary

#
Task

#
Task::is_effectively_phony

#
TaskPlan

#
VisitState

#
audit_code_label

#
audit_project

#
audit_severity_label

#
audit_status

#
benchmark_description

#
benchmark_specs

#
build_benchmark_project

#
clean_project

#
doctor

#
duplicate_outputs

#
empty_cache

#
explain_task

#
help_text

#
list_tasks

#
load_cache

#
load_project

#
make_plan

#
metrics_csv_header

#
metrics_csv_row

#
parse_cli

#
plan_for_task

#
project_stats

#
reason_message

#
render_audit_report

#
render_graph

#
render_project_stats

#
render_run_metrics

#
run_metrics

#
run_target

#
save_cache

#
task_levels

#
task_order

#
task_summary_line

#
validate_project