Skip to content

ARAS Phase 1: ascending reticular activating system (global arousal gate)#123

Closed
TSchonleber wants to merge 1 commit into
mainfrom
brain-regions-aras-phase-1
Closed

ARAS Phase 1: ascending reticular activating system (global arousal gate)#123
TSchonleber wants to merge 1 commit into
mainfrom
brain-regions-aras-phase-1

Conversation

@TSchonleber
Copy link
Copy Markdown
Owner

Summary

Phase 1 of the ARAS subsystem — brainstem-level global arousal broadcast. Sits above LC + NB. The May 15 brain_region_coverage.md audit flagged it on the 🟡 partial list. Phase 1 is inspection-only.

What's in

  • Migration 069 — 3 tables (aras_triggers, aras_state, aras_transitions). Single-row aras_state seed. 5 trigger classes seeded.
  • agentmemory.mcp_tools_aras — 5 MCP tools.
  • 9 tests — all green.
  • Design proposal at docs/proposals/aras.md.

What's NOT in

  • No behavior change to LC, NB, retrieval, or any existing subsystem.
  • No shadow consult wiring (Phase 2).
  • No LC/NB response modulation (Phase 3).

Live

  • Backup: ~/agentmemory/backups/brain.db.pre-aras-20260520T044840Z.db
  • Migration 069 applied to live brain.db.
  • 9/9 tests green.

Test plan

🤖 Generated with Claude Code

…uation)

Brainstem-level global arousal broadcast. Sits ABOVE LC + NB —
ARAS gates whether the rest of the neuromod surface is responsive
at all. Anesthesia = ARAS shutdown; waking = ARAS ramp.

The May 15 brain_region_coverage.md audit flagged it on the 🟡
partial list: "neuromodulation_state table holds org-level
arousal/focus. Not wired into retrieval/admission."

Phase 1 is inspection-only / additive. No behavior change to LC,
NB, retrieval, or any existing subsystem.

- Migration 069 — 3 tables (aras_triggers, aras_state with
  sleep_wake_mode + arousal_level + tonic_drive + phasic_alertness,
  aras_transitions). Single-row aras_state seed. 5 seed trigger
  classes (novel_query, high_pe_event, consolidation_complete,
  idle_30min, explicit_user_alert).

- agentmemory.mcp_tools_aras — 5 MCP tools:
  - aras_status: current state + last 5 transitions + 24h summary
  - aras_transition: explicit mode change with soft-pull arousal update
  - aras_drive: phasic arousal pulse via registered trigger;
    auto-fires aras_transition on |delta|>=0.2 or phasic>=0.7
  - aras_register_trigger: idempotent UPSERT on aras_triggers
  - aras_history: paginated transitions with mode + agent filters

- 9 tests covering migration seeds, empty state, transitions,
  invalid mode rejection, drive deltas, auto-transition logic,
  unknown-trigger rejection, idempotent registration, history filters.

- Design proposal at docs/proposals/aras.md.

Phase 2 (separate PR) wires ARAS into the dispatch shadow consult to
log would-be mode transitions from event patterns. Phase 3 lets ARAS
modulate the downstream LC/NB response (low arousal damps LC phasic
firings; high arousal amplifies NB attention bursts). Phase 4 enforces.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@TSchonleber
Copy link
Copy Markdown
Owner Author

Superseded by #138 (brainctl-consolidation-v2), which already merged this work into main as part of the v2 tool surface consolidation. Closing as redundant.

@TSchonleber TSchonleber deleted the brain-regions-aras-phase-1 branch May 21, 2026 08:15
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant