mirror of
https://gh-proxy.org/https://github.com/klinsmaya/multica.git
synced 2026-11-09 09:56:47 +08:00
LinYushen
5fa65bd125
* feat(billing): enforce Cloud issue count limits * fix(billing): address issue limit review feedback * test(billing): exercise validation as manager * fix(billing): resolve second review feedback * fix(core): preserve entitlement limit discrimination
72 lines
4.2 KiB
Go
72 lines
4.2 KiB
Go
// Package dispatch holds the canonical, cross-layer vocabulary for execution
|
|
// admission outcomes (MUL-4525). It is a leaf package (no internal deps) so both
|
|
// the service layer — which MAKES the admission/skip decision and therefore owns
|
|
// the reason at its source — and the handler layer — which serializes it to the
|
|
// wire — share one enum and can never drift.
|
|
//
|
|
// A ReasonCode is decided at the branch that blocks/skips a run and carried
|
|
// through to the response verbatim; it is never reverse-engineered from a
|
|
// human-readable failure string. Codes are stable, localizable by clients, and
|
|
// enumeration-safe: a code never reveals whether a private agent exists, its
|
|
// name, or its owner.
|
|
package dispatch
|
|
|
|
// ReasonCode is a stable, client-localizable admission/dispatch reason.
|
|
type ReasonCode string
|
|
|
|
const (
|
|
// ReasonQueued / ReasonCoalesced / ReasonDeferred are the success-path codes.
|
|
ReasonQueued ReasonCode = "queued"
|
|
ReasonCoalesced ReasonCode = "coalesced"
|
|
ReasonDeferred ReasonCode = "deferred"
|
|
|
|
// ReasonInvocationNotAllowed: the acting principal may not trigger this
|
|
// target under the invocation-permission model. Deliberately generic — it
|
|
// does not distinguish "target is private" from "target does not exist".
|
|
ReasonInvocationNotAllowed ReasonCode = "invocation_not_allowed"
|
|
// ReasonTargetUnavailable: the target cannot run (archived agent, deleted /
|
|
// archived squad, unresolvable leader, or no assignee).
|
|
ReasonTargetUnavailable ReasonCode = "target_unavailable"
|
|
// ReasonRuntimeOffline: the target is permitted and bound to a runtime, but
|
|
// that runtime is not online at dispatch time. The task is not lost — the
|
|
// user's fix is to bring the machine back, and queued work waits for it.
|
|
ReasonRuntimeOffline ReasonCode = "runtime_offline"
|
|
// ReasonRuntimeUnusable: the target is bound to a runtime whose machine is
|
|
// reachable, but whose agent CLI cannot be executed there — the npm
|
|
// placeholder stub left behind when a package's postinstall was blocked is
|
|
// the case in the field (MUL-6164). Distinct from runtime_offline for the
|
|
// same reason agent_runtime_required is: waiting changes nothing here. The
|
|
// machine is already on, and the fix is a command the user runs on it, which
|
|
// the daemon reports with this verdict so clients can show it.
|
|
ReasonRuntimeUnusable ReasonCode = "runtime_unusable"
|
|
// ReasonAgentRuntimeRequired: the target is permitted but bound to no
|
|
// runtime at all (agent.runtime_id IS NULL), which is where an agent lands
|
|
// when its runtime is deleted (MUL-5559). Distinct from runtime_offline on
|
|
// purpose: there is no machine to bring back, nothing will ever claim work
|
|
// for this agent, and the only fix is binding it to a runtime. Clients that
|
|
// collapse the two send the user looking for an offline computer that does
|
|
// not exist.
|
|
ReasonAgentRuntimeRequired ReasonCode = "agent_runtime_required"
|
|
// ReasonAttributionBlocked: a fail-closed workspace could not resolve a
|
|
// responsible human for the run, so it was refused.
|
|
ReasonAttributionBlocked ReasonCode = "attribution_blocked"
|
|
// ReasonAlreadyActive: a run is already active/pending for this target and
|
|
// this trigger did not coalesce.
|
|
ReasonAlreadyActive ReasonCode = "already_active"
|
|
// ReasonSelfTriggerSuppressed: the target was intentionally not (re-)triggered
|
|
// because doing so would be a self-trigger the guard suppresses, and no active
|
|
// run remains to cover it — e.g. a squad leader's own @mention of its squad
|
|
// whose latest task is already terminal. Not a permission block, but NOT
|
|
// success: nothing new runs. (Named to avoid implying the NEW comment was
|
|
// already processed.)
|
|
ReasonSelfTriggerSuppressed ReasonCode = "self_trigger_suppressed"
|
|
// ReasonQuotaExceeded is a policy-neutral refusal for an exhausted
|
|
// Cloud-provided autopilot interval.
|
|
ReasonQuotaExceeded ReasonCode = "quota_exceeded"
|
|
// ReasonIssueLimitReached means a create_issue Autopilot was admitted for a
|
|
// run, but Cloud's effective workspace issue-count limit blocked the issue.
|
|
ReasonIssueLimitReached ReasonCode = "issue_limit_reached"
|
|
// ReasonInternalError: an unexpected server error prevented a clean decision.
|
|
ReasonInternalError ReasonCode = "internal_error"
|
|
)
|