multiui

type AggregateStats struct {
	TotalProjects int `json:"total_projects"`
	ActiveRuns    int `json:"active_runs"`
	TotalTasks    int `json:"total_tasks"`
	DoneTasks     int `json:"done_tasks"`
	FailedTasks   int `json:"failed_tasks"`
	TotalSteps    int `json:"total_steps"`
}

type Health string

type ProjectEntry struct {
	Name string `json:"name"`
	Path string `json:"path"`

	// Owner records which dashboard user created/owns this project when the
	// Web UI runs with OIDC authentication enabled. The value is the
	// oidcauth.Identity.OwnerKey() — lowercased email, or "sub:<subject>"
	// when the IdP supplies no email. Empty means unowned/shared: the
	// project is visible to every authenticated user. The field is ignored
	// entirely when OIDC is disabled.
	Owner string `json:"owner,omitempty"`

	// HiddenFor lists the viewers who have hidden this project from their
	// dashboard. Values are viewer keys in the same namespace as Owner (see
	// SetHidden).
	//
	// This is a per-viewer set rather than a single bool because the
	// registry is one file shared by every user of a hub. A global flag
	// would mean one user decluttering their own dashboard blanks the
	// project out of everyone else's — the same tenancy mistake a global
	// task list would be.
	//
	// Hiding is presentation only. It is deliberately *not* access control:
	// a hidden project stays in the caller's project list (flagged via
	// ProjectStatus.Hidden) so index-addressed routes keep resolving to the
	// same project, and so the settings panel can offer it back. Owner
	// governs who may see a project at all; this governs who wants to.
	HiddenFor []string `json:"hidden_for,omitempty"`
}

type ProjectStatus struct {
	Name   string `json:"name"`
	Path   string `json:"path"`
	Status string `json:"status"` // state.Status field value
	// PauseReason explains a "paused" Status — which condition stopped the
	// run and, for a usage cap, when it lifts. Nil for every other status.
	// Without it a project card can only say "paused", which is the same word
	// for a run waiting on a human and one that resumes by itself at 14:50.
	PauseReason  *pausereason.Reason `json:"pause_reason,omitempty"`
	Health       Health              `json:"health"` // computed indicator
	Goal         string              `json:"goal"`
	TotalTasks   int                 `json:"total_tasks"`
	DoneTasks    int                 `json:"done_tasks"`
	FailedTasks  int                 `json:"failed_tasks"`
	ActiveTasks  int                 `json:"active_tasks"`
	TotalSteps   int                 `json:"total_steps"`
	LastActivity time.Time           `json:"last_activity"`
	// LastStepTime is the timestamp of the project's most recent step. It is
	// kept off the wire and exists so RefreshHealth can re-derive staleness
	// from a cached status without reloading the project.
	LastStepTime time.Time `json:"-"`
	Provider     string    `json:"provider,omitempty"`
	Model        string    `json:"model,omitempty"`
	PMMode       bool      `json:"pm_mode"`
	HasProject   bool      `json:"has_project"` // false if no state file found
	Running      bool      `json:"running"`     // true if cloop run is actually executing

	// Error explains why a registered project could not be loaded.
	//
	// HasProject=false answers two very different questions with the same
	// value: "this directory was never initialised" and "this project exists
	// but its database would not open". On 2026-09-14 the second happened to
	// all 18 projects at once — a schema skew refused every state.db — and the
	// dashboard rendered them as 18 initialised-looking cards with no goal and
	// no tasks, because a discarded error looks exactly like an empty project
	// (Task 20254).
	//
	// Only real faults are reported. A directory that is simply not a cloop
	// project is the normal state of a freshly registered path and leaves this
	// empty, so the field's presence always means something is wrong.
	Error string `json:"error,omitempty"`

	// Hidden reports that the recipient of this payload has hidden the
	// project from their dashboard. It is per-recipient, so GetStatus
	// deliberately leaves it false: the status cache is shared by every
	// connected client, and the flag is stamped on a per-recipient copy
	// when the list is filtered for delivery.
	//
	// Hidden projects are still delivered. Dropping them would renumber
	// the list, and the whole dashboard addresses projects by their index
	// in it — a hidden project at index 2 would silently shift every
	// project after it onto a neighbour's tasks, runs and deletes.
	Hidden bool `json:"hidden,omitempty"`
}

type RunningDirs struct {
	// contains filtered or unexported fields
}