# Psyclone AIOS & CMSDK 2.2.0 — Release Notes

**Released 22 August 2026** · Psyclone (LGPL) + CMSDK (BSD) · 64-bit Linux, macOS and Windows

2.2.0 is a major capability release. It introduces three headline features that together turn Psyclone from a real-time messaging fabric into a **self-describing, supervised, LLM-connected platform**: the **Builder** bake pipeline, an automatic **Startup Supervisor**, and first-class **LLM Connections** in CMSDK — plus **multi-node bring-up** across separate OS processes. Every test suite passes on all three supported 64-bit platforms.

---

## Highlights

### 🏗️ Builders — a declarative bake pipeline
Bringing a Psyclone system up is now a **first-class, observable operation**. A *Recipe* carries a stable string **RecipeID** identity end-to-end, and every bake message carries five correlation entries so a bake can be tracked and reasoned about across the whole system. The bake stream is split into clean, typed channels:
- a **`.status`** stream carrying progress-only acknowledgements, and
- a **`.data`** stream carrying lossless, sequence-numbered payload with **gap detection** (a missing sequence is a hard error, never silent loss), a bounded reassembly buffer, and per-batch acks.

Bake **control** is properly governed — an issued-by allow-list, a monotonic control sequence, and *cancel-supersedes-pause* ordering — with per-verb control types (`BakeControl.Cancel/Restart/Pause/…`) and per-kind output types (`Bake.Start/Status/Success/…`). Interactive steps honour **fail | pause | skip** on timeout, and "blue-edit" knobs allow a running bake to be steered live.

### 🧭 Supervisor — automatic, supervised bring-up
A **Startup Supervisor** now owns system bring-up as a proper **Root-space crank** (the legacy `procID==0` fan-out and registry are gone). A `<supervisor>` PsySpec element creates it; it mints a Recipe ID, sends the recipe to the target node, streams `.status`/`.data` back, and drives PAUSE/START control with acknowledgements. The node broadcasts **`Psyclone.SystemStatus`** on a 5-second cadence, `Psyclone.Ready` now fires only once **all** components actually exist, and unregister drains in-flight dispatches for a clean teardown.

### 🔌 LLM Connections — talk to language models from CMSDK
CMSDK gains a first-class **`<llm>` / `<llmvendor>` connection primitive**. `LLMConnection` parses vendor/model config into typed errors and a stats struct, connects over the CMSDK HTTP client, and calls endpoints via `interact()` with JSON path extraction. It supports both a **request/response mode (mode-A)** and a **streaming mode (mode-B)**, backed by a real streaming transport stack — an **SSE parser**, an **HTTP chunked decoder**, a bounded **byte-source pump**, and an **event-stream frame parser** that validates the AWS event-stream prelude and per-message CRCs. Credentials resolve from **environment-variable or file references** (inline secrets in a spec are rejected), and **SSL client verification on Windows** now imports the Windows ROOT system store so certificate verification works on end-user machines.

### 🌐 Multi-node bring-up
Psyclone now brings up a **distributed model across multiple OS-process nodes**. `bringUpSpec` is multi-node-aware (groups components by `node=`, defers unknown nodes), routes `Psyclone.Builder.*` to the target node, and forwards cross-node recipes and triggergroup joins — including ID-reservation adoption ordering, context ID-clash tie-break, and `SYNC_COMPONENT_INFO` confirmation. A new self-checking **`test=psymulti`** runs three real OS-process nodes under Supervisor orchestration.

### 🐛 Hardening
Alongside the features, 2.2.0 lands a substantial reliability pass: reliable POSIX shared-segment cleanup, a memory-safety sweep under a new **ASan gate** (use-after-free, `new[]`/scalar-`delete` mismatches, leaks, an over-read), flake-1 shutdown hardening (cancel-safe teardown, no `pthread_cancel` of a mutex holder), NetworkManager map-corruption fixes, and Windows portability fixes for the concurrency-fuzz suite.

---

## Platforms & downloads

| Platform | Build | `test=cmsdk` | system suite |
|---|---|---|---|
| Linux 64-bit | clean | 60/60 pass | psytest 7/7 pass |
| macOS 64-bit (Apple Silicon/Intel) | clean | pass* | pass* |
| Windows 64-bit | 0 warnings / 0 errors | pass* | pass* |

<sub>*macOS and Windows verification confirmed on their respective build hosts as part of this release.</sub>

**Distributions (2.2.0):**
- Source — Psyclone (LGPL): `Psyclone_LGPL_2.2.0.260822.zip`
- Source — CMSDK (BSD): `CMSDK_BSD_2.2.0.260822.zip`
- Binary — Linux 64: `Psyclone_binary_linux64_2.2.0.260822.zip`
- Binary — macOS 64: `Psyclone_binary_macos64_2.2.0.260822.zip`
- Binary — Windows 64: `Psyclone_binary_win64_2.2.0.260822.zip`

Every binary distribution includes the Python 3 module (`cmsdk3` + `PsyPython3Link`) as a first-party component, plus this release-notes file and the changelog.

---

## Building from source
All three platforms build with the standard toolchain; **SWIG** is required to (re)generate the Python bindings (`make swig3`, or automatically when SWIG is on `PATH`). See `CHANGELOG-2.2.0.md` for the complete per-component detail.

*Psyclone AIOS is a distributed, real-time publish/subscribe platform with sub-100µs messaging, built on the open-source CMSDK library. — Communicative Machines / CMLabs*