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.
This commit is contained in:
@@ -0,0 +1,192 @@
|
||||
package brain
|
||||
|
||||
import (
|
||||
"context"
|
||||
"errors"
|
||||
"log/slog"
|
||||
"os"
|
||||
"sync/atomic"
|
||||
"testing"
|
||||
"time"
|
||||
|
||||
"github.com/andydixon/noema/internal/attention"
|
||||
evstore "github.com/andydixon/noema/internal/events"
|
||||
"github.com/andydixon/noema/internal/minds"
|
||||
"github.com/andydixon/noema/internal/scheduler"
|
||||
"github.com/andydixon/noema/internal/storage"
|
||||
"github.com/andydixon/noema/internal/workspace"
|
||||
"github.com/andydixon/noema/migrations"
|
||||
"github.com/andydixon/noema/pkg/events"
|
||||
"github.com/andydixon/noema/pkg/ids"
|
||||
)
|
||||
|
||||
// echo proposes one candidate per new external event; repeat proposes the
|
||||
// same subject every cycle to exercise the loop detector; boom panics.
|
||||
type echo struct{ calls atomic.Int32 }
|
||||
|
||||
func (e *echo) Name() string { return "echo" }
|
||||
func (e *echo) Observe(_ context.Context, s *State) ([]Candidate, error) {
|
||||
e.calls.Add(1)
|
||||
var out []Candidate
|
||||
for _, ev := range s.NewEvents {
|
||||
if ev.Type == events.Observation {
|
||||
out = append(out, Candidate{Kind: "attend", Subject: string(ev.ID), Summary: "noticed: " + ev.Summary, Features: attention.Features{Salience: ev.Salience, Urgency: 0.5}, Confidence: 1, SourceEvents: []ids.ID{ev.ID}})
|
||||
}
|
||||
}
|
||||
return out, nil
|
||||
}
|
||||
|
||||
type repeat struct{}
|
||||
|
||||
func (repeat) Name() string { return "repeat" }
|
||||
func (repeat) Observe(_ context.Context, s *State) ([]Candidate, error) {
|
||||
return []Candidate{{Kind: "note", Subject: "same-thing", Summary: "the same thought again", Features: attention.Features{Salience: 0.9}, Confidence: 0.5}}, nil
|
||||
}
|
||||
|
||||
type boom struct{}
|
||||
|
||||
func (boom) Name() string { return "boom" }
|
||||
func (boom) Observe(context.Context, *State) ([]Candidate, error) { panic("malformed input") }
|
||||
|
||||
type failing struct{}
|
||||
|
||||
func (failing) Name() string { return "failing" }
|
||||
func (failing) Observe(context.Context, *State) ([]Candidate, error) {
|
||||
return nil, errors.New("upstream down")
|
||||
}
|
||||
|
||||
func setup(t *testing.T, reg *Registry) (Config, minds.Mind, *evstore.Store) {
|
||||
t.Helper()
|
||||
pool := storage.TestPool(t, migrations.FS)
|
||||
ctx := context.Background()
|
||||
ms := minds.NewStore(pool)
|
||||
m, err := ms.Create(ctx, minds.CreateParams{Slug: "brain"})
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
es := evstore.NewStore(pool, evstore.NewBus(16), nil)
|
||||
cfg := Config{DB: pool, Events: es, Minds: ms, Registry: reg, Pool: scheduler.NewPool(2), Log: slog.New(slog.NewTextHandler(os.Stderr, nil)), Services: Services{Events: es}}
|
||||
return cfg, m, es
|
||||
}
|
||||
|
||||
func TestCycleRecordsProvenanceAndPersists(t *testing.T) {
|
||||
e := &echo{}
|
||||
cfg, m, es := setup(t, NewRegistry().AddProcess(e).AddProcess(boom{}).AddProcess(failing{}))
|
||||
ctx := context.Background()
|
||||
rt, err := NewRuntime(ctx, cfg, m)
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
rt.now = func() time.Time { return time.Now().Add(time.Second) } // events are "settled"
|
||||
obs, _ := es.Append(ctx, events.New{MindID: m.ID, Type: events.Observation, Source: "test", Summary: "load spike on atlas", Salience: 0.9, Confidence: 1})
|
||||
rt.runCycle(ctx, "operator")
|
||||
|
||||
if e.calls.Load() != 1 {
|
||||
t.Fatalf("echo called %d times", e.calls.Load())
|
||||
}
|
||||
st := rt.copyState()
|
||||
if st.Cycle != 1 || len(st.Workspace) != 1 || st.Workspace[0].Subject != string(obs[0].ID) || len(st.WorkingMemory) != 1 {
|
||||
t.Fatalf("workspace wrong: %+v", st)
|
||||
}
|
||||
all, _ := es.Query(ctx, evstore.Filter{MindID: m.ID, Ascending: true})
|
||||
types := map[events.Type]int{}
|
||||
var selected events.Event
|
||||
for _, ev := range all {
|
||||
types[ev.Type]++
|
||||
if ev.Type == events.ThoughtSelected {
|
||||
selected = ev
|
||||
}
|
||||
}
|
||||
for _, want := range []events.Type{events.ThoughtCandidate, events.ThoughtSelected, events.WorkspaceBroadcast, events.AttentionShift, events.CycleCompleted} {
|
||||
if types[want] == 0 {
|
||||
t.Fatalf("missing %s in %v", want, types)
|
||||
}
|
||||
}
|
||||
// Provenance: selected thought → candidate event → observation.
|
||||
if selected.CausationID.IsZero() {
|
||||
t.Fatal("thought_selected has no causation")
|
||||
}
|
||||
cand, _ := es.Get(ctx, selected.CausationID)
|
||||
if cand.Type != events.ThoughtCandidate || cand.CausationID != obs[0].ID {
|
||||
t.Fatalf("provenance chain broken: %+v", cand)
|
||||
}
|
||||
if cur, _ := es.Cursor(ctx, cfg.DB, m.ID, cursorConsumer); cur != obs[0].Seq {
|
||||
t.Fatalf("cursor %d, want %d", cur, obs[0].Seq)
|
||||
}
|
||||
// Restart continuity: a fresh runtime loads the same state.
|
||||
rt2, err := NewRuntime(ctx, cfg, m)
|
||||
if err != nil || rt2.state.Cycle != 1 || len(rt2.state.Workspace) != 1 {
|
||||
t.Fatalf("state not persisted: %v %+v", err, rt2.state)
|
||||
}
|
||||
// A second cycle with nothing new triggered by stimulus does nothing.
|
||||
rt2.now = rt.now
|
||||
rt2.runCycle(ctx, "stimulus")
|
||||
if rt2.state.Cycle != 1 {
|
||||
t.Fatal("cycle ran without input")
|
||||
}
|
||||
}
|
||||
|
||||
func TestLoopDetectorSuppressesRepeats(t *testing.T) {
|
||||
cfg, m, es := setup(t, NewRegistry().AddProcess(repeat{}))
|
||||
ctx := context.Background()
|
||||
m.Config.LoopDetectThreshold, m.Config.LoopDetectWindow = 3, 10
|
||||
rt, err := NewRuntime(ctx, cfg, m)
|
||||
if err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
rt.now = func() time.Time { return time.Now().Add(time.Second) }
|
||||
for i := 0; i < 6; i++ {
|
||||
es.Append(ctx, events.New{MindID: m.ID, Type: events.Observation, Source: "test", Summary: "tick", Salience: 0.1, Confidence: 1}) //nolint:errcheck
|
||||
rt.runCycle(ctx, "operator")
|
||||
}
|
||||
meta, _ := es.Query(ctx, evstore.Filter{MindID: m.ID, Types: []events.Type{events.Metacognition}})
|
||||
if len(meta) != 1 {
|
||||
t.Fatalf("expected exactly one loop warning, got %d", len(meta))
|
||||
}
|
||||
cands, _ := es.Query(ctx, evstore.Filter{MindID: m.ID, Types: []events.Type{events.ThoughtCandidate}})
|
||||
var suppressed int
|
||||
for _, c := range cands {
|
||||
if c.Metadata["fate"] == "suppressed" {
|
||||
suppressed++
|
||||
}
|
||||
}
|
||||
if suppressed != 3 {
|
||||
t.Fatalf("expected 3 suppressed candidates, got %d", suppressed)
|
||||
}
|
||||
}
|
||||
|
||||
func TestPauseResetAndCancellation(t *testing.T) {
|
||||
cfg, m, es := setup(t, NewRegistry().AddProcess(&echo{}))
|
||||
ctx, cancel := context.WithCancel(context.Background())
|
||||
defer cancel()
|
||||
rt, _ := NewRuntime(ctx, cfg, m)
|
||||
done := make(chan struct{})
|
||||
go func() { rt.Run(ctx); close(done) }() //nolint:errcheck
|
||||
if err := rt.Command(ctx, "pause", nil); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if err := rt.Command(ctx, "cycle", nil); err == nil {
|
||||
t.Fatal("cycle should be refused while paused")
|
||||
}
|
||||
if err := rt.Command(ctx, "resume", nil); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
if err := rt.Command(ctx, "reset", map[string]bool{"workspace": true, "working_memory": true}); err != nil {
|
||||
t.Fatal(err)
|
||||
}
|
||||
modes, _ := es.Query(ctx, evstore.Filter{MindID: m.ID, Types: []events.Type{events.ModeChanged}})
|
||||
if len(modes) != 2 {
|
||||
t.Fatalf("expected 2 mode changes, got %d", len(modes))
|
||||
}
|
||||
st, err := rt.Snapshot(ctx)
|
||||
if err != nil || st.Mode != string(ModeAwake) {
|
||||
t.Fatalf("snapshot: %v %+v", err, st)
|
||||
}
|
||||
cancel()
|
||||
select {
|
||||
case <-done:
|
||||
case <-time.After(2 * time.Second):
|
||||
t.Fatal("runtime did not stop on cancellation")
|
||||
}
|
||||
_ = workspace.State{}
|
||||
}
|
||||
Reference in New Issue
Block a user