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 FeatureStatus struct {
	Slug      string      `json:"slug"`
	Title     string      `json:"title"`
	Branch    string      `json:"branch"`
	Base      string      `json:"base"`
	CreatedAt time.Time   `json:"created_at"`
	CreatedBy string      `json:"created_by,omitempty"`
	AutoPR    bool        `json:"auto_pr,omitempty"`
	PR        *feature.PR `json:"pr,omitempty"`
	// AutoEvolve and Innovate are the feature's own run settings, shown on
	// its row in the parent's Features panel so the parallel lines of work
	// can be told apart at a glance.
	AutoEvolve bool `json:"auto_evolve,omitempty"`
	Innovate   bool `json:"innovate,omitempty"`
	// Return is what became of the last isolated run's work — a conflict
	// is what the dashboard flags (Task 20367).
	Return *feature.Return `json:"return,omitempty"`
}

type Health string

type HubProcess struct {
	PID int
	// Dir is the process's working directory: the directory whose control
	// plane it serves.
	Dir 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"`

	// Parent is set on an entry that is a feature of another project (Task
	// 20341): the parent project's path. Feature entries are never stored in
	// the registry — the dashboard discovers them under each project's
	// .cloop/features — so this field is only ever set in memory.
	Parent string `json:"parent,omitempty"`
	// Feature is the feature's slug when Parent is set.
	Feature string `json:"feature,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"`

	// Parent is the parent project's path when this project is a feature of
	// it, and Feature describes the feature (Task 20341). The dashboard nests
	// features under their parent with these; everything else about a feature
	// — its tasks, its run, its options — is an ordinary project status.
	Parent  string         `json:"parent,omitempty"`
	Feature *FeatureStatus `json:"feature,omitempty"`

	// Confinement says why the hub refuses to run this project, when its
	// directory overlaps the hub's control plane, another hub or another
	// project (Task 20418). Empty for every project the hub will run. The hub
	// fills it in; GetStatus, which knows nothing of the hub, leaves it empty.
	Confinement string `json:"confinement,omitempty"`

	// HasGit reports that a (non-feature) project is the top of a git
	// repository — the precondition for creating features of it, which the
	// dashboard checks before offering the button.
	HasGit bool `json:"has_git,omitempty"`
}

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