Installer cut to OOTB simplicity. The one-liner now does only the OS-essentials: prereq check (git + python3) → sparse-clone kody-w/RAPP for rapp_brainstem/ + installer/ → venv → pip install → auto-launch on :7071 → open browser. Sacred URL preserved (Article V); content shrinks ~92%.
Reserved agents pattern (new). First-party lifecycle code ships in utils/reserved_agents/, follows the same BasicAgent contract, but lives outside the kernel's agents/*_agent.py auto-discovery glob. They never enter the LLM's default tool palette — they're invoked on demand by the lifecycle organ.
Lifecycle organ./api/lifecycle/ exposes the catalog of reserved agents; /api/lifecycle/upgrade (POST) drives the kernel-upgrade reserved agent. Wire-level confirm: non-read actions refuse without confirm: true in the request body.
First reserved agent — upgrade_brainstem. Three-phase upgrade: snapshot via utils/bond.pack_organism → re-run the minimal installer in subprocess → verify health (rollback hint via egg path if anything regresses).
Soul.md handshake protocol. New <lifecycle_handshake> section teaches the LLM to explain → get explicit yes → POST with confirm:true → report artifact path. Defense in depth: organ enforces the same contract on the wire even if the LLM forgets the protocol.
Cut from the installer (now LLM-driven, on demand): bond cycle, backups-as-git-repo, emergency baseline seeding, upgrade-confirmation flow, brainstem CLI subcommands (egg, hatch, ls, identity, doctor, safe-mode, backups), peer/registry, service install (launchd/systemd), boot.py wrapper. None of this disappeared from the platform — it just moved from pre-flight bash to runtime conversation.
Article XXXIX added to the Constitution. Codifies the new pattern: humans only touch the curl one-liner; everything else is LLM-to-LLM via /chat. The brainstem replies in plain-English "report cards sent home from school" — never JSON, never paths, never routes the user has to memorize. The metaphor: electric bicycle for the mind — humans do the fun work (decide, enjoy), LLMs do the hard work (parse routes, hold confirmation state, translate the answer). Peer brainstem-to-brainstem is the cross-LLM determinism test case.
v0.15.0 – v0.15.9 brainstem-v0.15.x
Boot wrapper, model persistence, RAPPZoo/Pokédex, sprite art, Settings panel polish.
v0.15.9 — pixel sprites get true 16×16 detail (per-rappid hash → species/color/pattern); RAPPZoo card chrome rebranded "Trapper-Keeper" for the holographic-binder vibe.
v0.15.8 — Settings: "Pokédex" → "RAPPZoo", no stale errors on first load, no overflow on long org names.
v0.15.7 — Settings: egg export sits next to the RAPPZoo link (one organism-in/organism-out concept).
v0.15.6 — rapp-zoo Pages site moves into this repo at rapp-zoo/; Settings panel decluttered.
v0.15.5 — egg export moves into Settings; rapp-zoo header link points at the Pages copy.
v0.15.4 — model selection survives kernel restart (/models/set now persists); boot banner reflects the active model instead of the .env default.
v0.15.3 — egg filenames carry the full rappid + UTC stamp so two organisms on the same machine can't collide.
v0.15.2 — installer output: calmer, terser, fewer scary lines on the happy path.
v0.15.1 — installer launches via utils/boot.py wrapper (not raw python brainstem.py) so /api/snapshot/*, /api/senses/*, /api/workspace/* are wired uniformly across foreground / cmd_run / launchd / systemd / project-local.
v0.15.0 — boot.py-native .egg export/import + opt-in upgrades (one-liner short-circuits at "already up to date" when local VERSION matches latest tag) + safety net for partial downloads.
v0.14.2 — Article XXXVIII: canonical organism shape + federation pattern. The schema other AI assistants (Claude Code, Copilot, Cursor) read first to avoid re-inventing parallel architectures.
v0.14.1 — Tier C polish: Article XXXVII (rapplications ARE organisms), /api/lineage walker for the rapp-zoo Pokédex, anatomy diagram link in Settings, README/CLAUDE refresh.
v0.14.0 — brainstem-egg/2.2-rapplication schema. Rapplications are organisms with smaller scope — same egg layout, tighter include set. Adds pack_rapplication() + unpack_rapplication().
v0.13.0 – v0.13.3 brainstem-v0.13.x
Local installs become first-class digital organisms with persistent identity + bonding lifecycle.
v0.13.3 — GET /api/identity reads ~/.brainstem/{rappid,bonds}.json; organism rappid surfaces in the boot banner.
v0.13.2 — installer: bond cycle survives older pins; honest version messaging when a pre-bond install runs the upgrade.
v0.13.1 — Cloud UI source toggle: flip / between local index.html and the live GitHub Pages copy without re-running the installer.
v0.13.0 — bonding lifecycle: every local install gets a perpetual rappid at first hatch; one-liner runs egg → overlay → hatch on every kernel upgrade so identity, soul, custom agents, and memory survive in place. Implemented in utils/bond.py.
v0.12.3 brainstem-v0.12.3
CORS tightened + /debug/auth no longer returns the Copilot token body.
CORS allowlist replaces the previous * wildcard. Default allowed origins: localhost / 127.0.0.1 on any port, and https://kody-w.github.io. Extend via RAPP_CORS_ORIGINS env var (comma-separated) if a browser UI you rely on breaks.
/debug/auth now reports exchange_ok + exchange_error_code on failure instead of the raw GitHub→Copilot exchange response body (which contained the live Copilot bearer token on success).
Closes a cross-origin drive-by class where any visited webpage could hit localhost:7071 and exfiltrate the Copilot token or upload an agent.
v0.12.1 brainstem-v0.12.1
UI backport to v0.6.0 classic chrome — same muscle memory, all v0.12 features kept.
Default look restored to the v0.6.0 screenshot users were trained on: icon-only header buttons, uncluttered chrome.
No feature regression. Twin portrait, swarm management, index cards, Settings panel, .egg export, VS Code link, voice toggle, starter prompts — all still there, shown when their mode turns on.
Tier 2 deploy pipeline small fixes: agents copied (not symlinked) so func publish zip survives; provision-twin-lite.sh env-var filter extended.
v0.12.0 brainstem-v0.12.0
Three Tiers, One Model — tier-2 adoption + sacred brainstem + constitution cleanup.
Article I-A added:brainstem.py is sacred. Bug fixes only; features go in agents/.
Article II rewritten: one Tier 2 deployment serves many users via user_guid body field; shared agents/ tree + per-user memory via storage_manager.set_memory_context(user_guid). Matches the Power Automate flow 1:1.
Article IX rewritten: workshop → singleton distribution. Retired the sibling-swarm invocation family (invoke / deploy / list / info / seal / snapshot / delete).
Article VI-A retired: no more per-user "hatching."
Tier 2 function_app.py replaced with the CommunityRAPP Base Memory Agent Platform body. Six cloud utils vendored (azure_file_storage, copilot_auth, storage_factory, local_file_storage, result, environment).
Agents cleanup: 17 agents removed (7 retired swarm family + 10 experimental). swarm_factory_agent promoted out of system_agents/.
brainstem.py bug fixes (Article I-A permits): shim import path + recursive agent discovery (Article XII alignment).
E2E test scripts added under tests/e2e/. Tier 1 smoke + memory/factory + Tier 2 local all green. Tier 2 cloud deferred (subscription policy).
v0.11.7 brainstem-v0.11.7
README rewrite for technical readers + pitch deck "Receipts" slide.
Foundational releases: the one-liner installer, Copilot API auth chain, agent auto-discovery, soul file, diagnostics flight recorder. See
the full tag list on GitHub for the complete history.