Files
Andy Dixon e9c1b25c80 feat: implement global workspace, working memory and the cognitive cycle
Phase 4 (ADR-0001). internal/attention scores thought candidates as a
normalised weighted sum over ten named features with a per-term
breakdown, ranked by (score, id) so ordering is total and replayable.
internal/workspace holds the capacity-limited workspace (refresh by
subject, decayed competition, explained admit/reject outcomes) and the
decaying working memory.

internal/brain runs one runtime per active mind: debounced wake-ups from
the event bus (own output never re-triggers), a settle window so
concurrently committing events are not skipped, bounded concurrent
Observe calls with per-process isolation and timeouts, deterministic
scoring, a loop detector that suppresses recurring thoughts and raises a
metacognition warning, executive dispatch by thought kind, and one
transaction per cycle whose events are published only after commit.
Every candidate, selection, attention shift and broadcast is an event
with provenance back to the triggering observation. Operators can run a
cycle, pause, resume, reset transient state and change attention
weights live; the manager reconciles runtimes with mind status.

cognition/attend is the first process: deterministic candidates from
external events using an urgency lexicon, novelty against context and
trust-based operator priority.
2026-06-18 22:54:07 +01:00

139 lines
3.3 KiB
Go

package brain
import (
"context"
"errors"
"strings"
"sync"
"time"
"github.com/andydixon/noema/internal/minds"
"github.com/andydixon/noema/internal/scheduler"
"github.com/andydixon/noema/pkg/ids"
)
// Manager owns one Runtime per active mind, wakes them on new events and
// reconciles with the minds table so enabling or disabling a mind in the UI
// takes effect without a restart.
type Manager struct {
cfg Config
group *scheduler.Group
mu sync.RWMutex
runtimes map[ids.ID]*entry
}
type entry struct {
rt *Runtime
cancel context.CancelFunc
done chan struct{}
}
// ErrNotRunning is returned for minds without a live runtime.
var ErrNotRunning = errors.New("mind runtime is not running")
// NewManager creates a manager; call Start to launch runtimes.
func NewManager(cfg Config, group *scheduler.Group) *Manager {
return &Manager{cfg: cfg, group: group, runtimes: map[ids.ID]*entry{}}
}
// Start launches runtimes for active minds, subscribes to the event bus for
// wake-ups and reconciles every 30s.
func (m *Manager) Start(ctx context.Context) error {
if err := m.Reconcile(ctx); err != nil {
return err
}
ch, err := m.cfg.Events.Bus().Subscribe(m.group.Context(), ids.Nil, 1024)
if err != nil {
return err
}
m.group.Go("brain.wake", func(ctx context.Context) error {
for {
select {
case <-ctx.Done():
return nil
case ev := <-ch:
if strings.HasPrefix(ev.Source, "brain") {
continue // our own output never re-triggers a cycle (T20)
}
if rt := m.Get(ev.MindID); rt != nil {
rt.Wake()
}
}
}
})
m.group.Every("brain.reconcile", 30*time.Second, m.Reconcile)
return nil
}
// Reconcile starts runtimes for active minds and stops the rest.
func (m *Manager) Reconcile(ctx context.Context) error {
list, err := m.cfg.Minds.List(ctx, true)
if err != nil {
return err
}
want := map[ids.ID]minds.Mind{}
for _, md := range list {
if md.Status == minds.StatusActive {
want[md.ID] = md
}
}
m.mu.Lock()
defer m.mu.Unlock()
for id, e := range m.runtimes {
if _, ok := want[id]; !ok {
e.cancel()
<-e.done
delete(m.runtimes, id)
m.cfg.Log.Info("mind runtime stopped", "mind", id)
}
}
for id, md := range want {
if _, ok := m.runtimes[id]; ok {
continue
}
rt, err := NewRuntime(ctx, m.cfg, md)
if err != nil {
m.cfg.Log.Error("cannot start mind runtime", "mind", md.Slug, "err", err)
continue
}
rctx, cancel := context.WithCancel(m.group.Context())
e := &entry{rt: rt, cancel: cancel, done: make(chan struct{})}
m.runtimes[id] = e
m.group.Go("brain."+md.Slug, func(context.Context) error {
defer close(e.done)
return rt.Run(rctx)
})
}
return nil
}
// Get returns the runtime for a mind or nil.
func (m *Manager) Get(id ids.ID) *Runtime {
m.mu.RLock()
defer m.mu.RUnlock()
if e, ok := m.runtimes[id]; ok {
return e.rt
}
return nil
}
// Command forwards an operator command to a mind's runtime.
func (m *Manager) Command(ctx context.Context, id ids.ID, kind string, args map[string]bool) error {
rt := m.Get(id)
if rt == nil {
return ErrNotRunning
}
return rt.Command(ctx, kind, args)
}
// Running lists the ids of minds with live runtimes.
func (m *Manager) Running() []ids.ID {
m.mu.RLock()
defer m.mu.RUnlock()
out := make([]ids.ID, 0, len(m.runtimes))
for id := range m.runtimes {
out = append(out, id)
}
return out
}