OuterBrain

OuterBrain is the provider-neutral semantic-runtime gateway above Citadel.

It owns durable semantic-session truth, tool-manifest snapshots, prompt and strategy shaping, semantic quality checkpoints, live session fencing, provider-neutral semantic failure carriers, and restart-safe reply publication. It does not own provider memory, RAG engines, or model-specific cognition as platform truth.

Scope

• raw input normalization
• durable semantic state and journaling
• context assembly
• prompt and strategy shaping
• provider-neutral semantic failure normalization
• normalized semantic activity contracts with bounded routing facts
• semantic context provenance, duplicate suppression, and redaction evidence
• structured action-request synthesis
• provisional and final reply publication
• restart-safe downstream follow-up

Status

Active workspace buildout. The repo uses a non-umbrella workspace layout with core packages, a dedicated raw-Ecto persistence layer, bridges, a host surface, and proving examples.

Adaptive layer additions:

• core/ai_artifact_contracts: ref-only artifact identity for prompt, role, skill, GEPA, eval, replay, router, provider, endpoint, promotion, and rollback refs.
• core/optimization_artifact_store: ref-only artifact graph history for candidate lineage, eval evidence, promotion, and rollback decisions.

Phase 7 persistence posture is carried through semantic sessions, prompt/ context provenance, journals, duplicate suppression, publication state, authority evidence, and projection/publication bridges. The default profile is memory/ref-only; durable refs are explicit, redacted evidence, and debug sidecar failure cannot mutate semantic-session, prompt provenance, suppression, publication, projection, or failure-journal state.

Development

The project targets Elixir ~> 1.19 and Erlang/OTP 28. The pinned toolchain lives in .tool-versions.

mix deps.get
mix ci

The welded outer_brain_contracts artifact is tracked through the prepared bundle flow:

mix release.prepare
mix release.track
mix release.archive

mix release.track updates the orphan-backed projection/outer_brain_contracts branch so downstream repos can pin a real generated-source ref before any formal release boundary exists.

Documentation

• docs/overview.md
• docs/layout.md
• docs/runtime_model.md
• docs/integration_surface.md
• CHANGELOG.md

This project is licensed under the MIT License. (c) 2026 nshkrdotcom. See LICENSE.

Temporal developer environment

Temporal runtime development is managed from /home/home/p/g/n/mezzanine through the repo-owned just workflow. Do not start ad hoc Temporal processes or rely on the temporal CLI as the implementation runbook.

Native Temporal development substrate

Temporal runtime development is managed from /home/home/p/g/n/mezzanine through the repo-owned just workflow, not by manually starting ad hoc Temporal processes.

Use:

cd /home/home/p/g/n/mezzanine
just dev-up
just dev-status
just dev-logs
just temporal-ui

Expected local contract: 127.0.0.1:7233, UI http://127.0.0.1:8233, namespace default, native service mezzanine-temporal-dev.service, persistent state ~/.local/share/temporal/dev-server.db.

Persistence Documentation

See docs/persistence.md for tiers, defaults, adapters, unsupported selections, config examples, restart claims, durability claims, debug sidecar behavior, redaction guarantees, migration or preflight behavior, and no-bypass scope when applicable.