Files
archie/internal/channels/status/status.go
T
sam a00c578cb7 refactor(ui): sever the archie-ui binary from every daemon runtime package
Completes the objective deletion gate for the UI Service
(archie-core-8cda.5.6): go list -deps ./cmd/archie-ui now links zero
banned packages -- no modernc.org/sqlite, no internal/store, gateway,
channels, memory, secret, agentexec, tools, skill, yaegiutil, curator,
or the workflow engine. The closure shrinks from 68 to 26 archie-core
packages. Each cut is a producer-side move; no consumer-side defensive
shims.

- Store contracts (TaskStore family, value types, sentinels) moved from
  internal/store to internal/domain/storecontract -- the approved contract
  location per state-store-contract rev. 2d, and NOT internal/contracts:
  that tree is buf generate output and tools/proto.sh check deletes
  hand-written files there. internal/store keeps aliases; sentinel
  message strings are byte-identical and remain the wire contract.
- Chat contracts (ChatContract, sessions, turns, streaming, commands)
  moved from internal/gateway to internal/domain/messaging; gateway keeps
  aliases. ToolCallEvent rendering helpers become gateway functions
  (methods cannot live on alias types).
- Task vocabulary (Task, statuses, mid-run Store, Definition) split into
  internal/domain/workflow/task; the pipeline engine stays in package
  workflow with aliases, so daemon-side callers are unchanged.
- overlay.DeniedKeys moved to internal/infrastructure/configuration:
  webui referenced the constant and that dragged the overlay SQLite
  store in.
- webui.Server's concrete runtime handles become webui-owned view
  interfaces with daemon-side bootstrap adapters: channel lifecycle
  (internal/channels/status), MemoryStatus, CuratorStatus, and a
  SkillCatalog seam replacing the direct skill.DefaultRoots/CatalogRoots
  calls. Each degrades to an empty page when unwired.
- config.SecretRef moved into internal/config (config vocabulary);
  internal/secret keeps an alias and Registry.Resolve absorbs the
  zero-value short-circuit.

Docs: state-store-contract rev. 2d relocation record; ui-service-boundary
deletion gate marked satisfied; ARCHITECTURE.md package map rows.
2026-09-10 03:03:33 +10:00

96 lines
2.7 KiB
Go

// Package status is the operator-facing channel lifecycle ledger: the
// State/Descriptor/Status vocabulary and the Manager that owns runtime
// facts for the dashboard and readiness surfaces. It lives beside the
// channels package rather than inside it so UI-process code can hold the
// types without linking the plugin contract there -- which references the
// gateway runtime (archie-core-8cda.5.6).
package status
import "sync"
// State reports the runtime lifecycle independently from whether a channel is
// present in configuration. A configured adapter can fail to start; an
// unconfigured adapter is simply stopped, not unhealthy.
type State string
const (
StateConfigured State = "configured"
StateStarting State = "starting"
StateRunning State = "running"
StateDegraded State = "degraded"
StateFailed State = "failed"
StateStopped State = "stopped"
)
// Descriptor is the safe, operator-facing declaration of one channel.
// Configuration values are intentionally not retained here: a manager must
// never become a second source for tokens or credentials.
type Descriptor struct {
ID string
Name string
Configured bool
ReloadSupported bool
Detail string
}
// Status is an immutable manager snapshot for a single channel.
type Status struct {
Descriptor
State State
}
// Manager owns channel lifecycle facts for the dashboard and other operator
// surfaces. It is deliberately typed to channels rather than extending the
// metadata-only plugin interface.
type Manager struct {
mu sync.RWMutex
channels []Status
index map[string]int
}
func NewManager(descriptors []Descriptor) *Manager {
m := &Manager{index: make(map[string]int, len(descriptors))}
for _, d := range descriptors {
state := StateStopped
if d.Configured {
state = StateConfigured
}
m.index[d.ID] = len(m.channels)
m.channels = append(m.channels, Status{Descriptor: d, State: state})
}
return m
}
func (m *Manager) Snapshot() []Status {
if m == nil {
return nil
}
m.mu.RLock()
defer m.mu.RUnlock()
return append([]Status(nil), m.channels...)
}
func (m *Manager) MarkStarting(id string) { m.set(id, StateStarting, "") }
func (m *Manager) MarkRunning(id string) { m.set(id, StateRunning, "") }
func (m *Manager) MarkDegraded(id, detail string) {
m.set(id, StateDegraded, detail)
}
func (m *Manager) MarkFailed(id, detail string) { m.set(id, StateFailed, detail) }
func (m *Manager) MarkStopped(id, detail string) { m.set(id, StateStopped, detail) }
func (m *Manager) set(id string, state State, detail string) {
if m == nil {
return
}
m.mu.Lock()
defer m.mu.Unlock()
i, ok := m.index[id]
if !ok {
return
}
m.channels[i].State = state
if detail != "" {
m.channels[i].Detail = detail
}
}