buildctl

type BuildResult struct {
	OK          bool         `json:"ok"`
	Stage       string       `json:"stage"`
	Step        string       `json:"step,omitempty"`
	Target      string       `json:"target,omitempty"`
	Recompiled  []Recompiled `json:"recompiled,omitempty"`
	MS          int64        `json:"ms"`
	Raw         string       `json:"raw,omitempty"`
	Diagnostics []Diagnostic `json:"diagnostics,omitempty"`
	// NowStale lists the artifacts this build's output just invalidated, in
	// pipeline order: e.g. "routes_gen", "wasm:/counter". The names are the
	// stage/artifact names; a wasm entry may be per-route ("wasm:/counter")
	// or the whole inventory ("wasm").
	NowStale   []string     `json:"nowStale,omitempty"`
	Counts     *StageCounts `json:"counts,omitempty"`
	Suppressed bool         `json:"suppressed,omitempty"`
	// Err is the raw error text of a failed stage ("" when OK).
	Err string `json:"err,omitempty"`
}

type Controller struct {

	// Executor seams. Nil = the production default bound over the CLI helpers;
	// tests replace them with fakes.
	TemplRun  func(file string) (string, error) // "" = all dirty files
	RoutesRun func(goModName string) error
	CssRun    func() error
	GoRun     func(binary string) (string, error)                     // combined captured output
	WasmRun   func(target string, snap Snapshot) (BuildResult, error) // the WASM stage incl. gate
	// contains filtered or unexported fields
}

type Diagnostic struct {
	Raw       string `json:"raw"`
	Diagnosis string `json:"diagnosis"`
	Fix       string `json:"fix"`
	Skill     string `json:"skill,omitempty"`
}

type DigestData struct {
	Digest           string   `json:"digest"`
	LocalPackageDirs []string `json:"localPackageDirs,omitempty"`
}

type Options struct {
	// MainBinary is the app build target ("tmp/main"); derived from the CLI
	// runtime when empty.
	MainBinary string
	// SyncEmbedded syncs the EMBEDDED-mode gothic_embed_gen.go — a host-layer
	// concern (the file's shape is decided by the command layer). Nil skips
	// the step.
	SyncEmbedded func(config *gothic_cli.Config) error
	// WasmLogf / WasmErrorf narrate the WASM stage the way the hosting
	// command's stream expects. No-ops when nil.
	WasmLogf   func(format string, args ...any)
	WasmErrorf func(format string, args ...any)
	// WasmInventory fires right before the WASM generate phase with the scan
	// inventory (pages, components, topics); the host prints its own line.
	WasmInventory func(pages, components, topics int)
	// BeginEdit suspends the host's watcher-driven rebuilds (stops arming
	// them) for the duration of an edit session; the returned function is
	// called when the session ends.
	BeginEdit func() (end func())
	// AfterSync fires after EditEnd's one Sync, so the host can re-arm its
	// rebuild cycle for the app binary and the reload.
	AfterSync func(res BuildResult)
}

type Recompiled struct {
	Path  string `json:"path"`
	Bytes int64  `json:"bytes"`
}

type Snapshot struct {
	Digest  string
	Dirs    []string
	Changed bool
}

type StageCounts struct {
	Rebuilt  int `json:"rebuilt"`
	UpToDate int `json:"upToDate"`
}

type StatusArtifact struct {
	Name string `json:"name"`
	// State is one of the Status* constants.
	State  string `json:"state"`
	Detail string `json:"detail"`
}

type StatusResult struct {
	// Rebuilding is true while any stage (foreground or the background WASM
	// compile) is running.
	Rebuilding bool `json:"rebuilding"`
	// Editing is true while an edit session holds the build lock.
	Editing   bool             `json:"editing"`
	Artifacts []StatusArtifact `json:"artifacts"`
}