feat!: rename PersonaPack to Ensemble + canvas-first builder

BREAKING CHANGE: The PersonaPack CRD has been renamed to Ensemble.
All API endpoints, labels, controllers, and UI references updated.

Rename (every layer):
- CRD: PersonaPack → Ensemble, PersonaPackSpec → EnsembleSpec, etc.
- API: /api/v1/personapacks → /api/v1/ensembles
- Labels: sympozium.ai/persona-pack → sympozium.ai/ensemble
- Controller: PersonaPackReconciler → EnsembleReconciler
- Frontend: all types, hooks, pages, components, routes
- TUI/CLI: all references in cmd/sympozium/main.go
- Docs: personapacks.md → ensembles.md, writing guide, architecture
- Helm: CRD YAML, RBAC, templates
- Cypress: all test files renamed and updated
- Integration tests: renamed and updated
- "Persona" retained for individual agents within an ensemble

Canvas-first ensemble builder:
- Provider setup gate (select provider + auth before canvas)
- ReactFlow canvas with add/remove persona nodes and drag-to-connect edges
- PersonaConfigPanel side panel with provider-aware model selector
  (useModelList with direct browser fetch fallback for LAN providers)
- EnsembleSettingsPanel for name, description, workflow type, shared memory
- Shared memory defaults to ON for new ensembles with toolbar toggle
- Ensemble name input directly in toolbar for discoverability
- POST /api/v1/ensembles (create) and POST /api/v1/ensembles/{name}/clone
- Route: /ensembles/new with "New Ensemble" button on list page

City distance workflow E2E test:
- Two-agent sequential ensemble (lead investigator + fact checker)
- Validates shared memory write by lead, read by checker
- Tests full lifecycle: create → activate → dispatch → verify → UI

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: AlexsJones

AGENTS.md

@@ -17,7 +17,7 @@ Sympozium is a **Kubernetes-native agent orchestration platform** written in Go.
 ## Repository Layout
 
 ```
-api/v1alpha1/           # CRD type definitions (SympoziumInstance, AgentRun, SympoziumPolicy, SkillPack, SympoziumSchedule, PersonaPack)
+api/v1alpha1/           # CRD type definitions (SympoziumInstance, AgentRun, SympoziumPolicy, SkillPack, SympoziumSchedule, Ensemble)
 cmd/
   agent-runner/         # Agent container — LLM loop + tool execution
   apiserver/            # HTTP + WebSocket API server
@@ -35,7 +35,7 @@ channels/
 config/
   crd/bases/            # Generated CRD YAML manifests
   manager/              # Controller manager deployment
-  personas/             # Built-in PersonaPack YAML definitions
+  personas/             # Built-in Ensemble YAML definitions
   rbac/                 # RBAC roles
   samples/              # Sample CR YAML files
   skills/               # Built-in SkillPack YAML definitions
@@ -45,7 +45,7 @@ images/                 # Dockerfiles for all components
 internal/
   apiserver/            # API server implementation
   channel/              # Channel types
-  controller/           # Reconcilers (AgentRun, SympoziumInstance, SympoziumPolicy, SympoziumSchedule, SkillPack, PersonaPack) + routers (Channel, Schedule)
+  controller/           # Reconcilers (AgentRun, SympoziumInstance, SympoziumPolicy, SympoziumSchedule, SkillPack, Ensemble) + routers (Channel, Schedule)
   eventbus/             # NATS JetStream client + topic constants
   ipc/                  # IPC bridge (fsnotify watcher, protocol, file handlers)
   orchestrator/         # Pod builder + spawner for agent Jobs
@@ -68,7 +68,7 @@ docs/                   # Design & contributor documentation
 | `SympoziumPolicy` | Policy rules enforced by the admission webhook |
 | `SkillPack` | Bundled skills (Markdown instructions) + optional sidecar container + RBAC |
 | `SympoziumSchedule` | Cron-based recurring AgentRun creation (heartbeat, scheduled, sweep) |
-| `PersonaPack` | Pre-configured agent bundles — stamps out Instances, Schedules, and memory automatically |
+| `Ensemble` | Pre-configured agent bundles — stamps out Instances, Schedules, and memory automatically |
 
 Type definitions live in `api/v1alpha1/`. After modifying types, regenerate with:
 
@@ -251,7 +251,7 @@ SkillPacks are CRDs containing Markdown instructions + optional sidecar definiti
 | Serving mode | `docs/serving-mode.md` | How serving mode works for long-lived agent deployments |
 | Sample CRs | `config/samples/` | Example SympoziumInstance, AgentRun, SympoziumPolicy, SympoziumSchedule, SkillPack |
 | CRD definitions | `api/v1alpha1/` | Go type definitions for all CRDs |
-| Built-in PersonaPacks | `config/personas/` | Pre-configured agent bundles (platform-team, devops-essentials) |
+| Built-in Ensembles | `config/personas/` | Pre-configured agent bundles (platform-team, devops-essentials) |
 
 ---
 
@@ -277,7 +277,7 @@ SkillPacks are CRDs containing Markdown instructions + optional sidecar definiti
 3. Run `make install` to apply updated CRDs to cluster
 4. Update the reconciler in `internal/controller/`
 
-### Adding a PersonaPack
+### Adding a Ensemble
 1. Create a YAML file in `config/personas/<name>.yaml`
 2. Define personas with system prompts, skills, schedules, and memory seeds
 3. Apply: `kubectl apply -f config/personas/<name>.yaml`

Makefile

@@ -71,12 +71,12 @@ test-integration: ## Run integration tests (requires Kind cluster + API keys)
 	./test/integration/test-mcp-bridge.sh
 	./test/integration/test-lifecycle-hooks.sh
 
-integration-tests: ## Run API smoke regression tests (PersonaPacks, ad-hoc Instances, Skills, Policies, Schedules)
+integration-tests: ## Run API smoke regression tests (Ensembles, ad-hoc Instances, Skills, Policies, Schedules)
 	bash ./test/integration/test-api-smoke.sh
-	bash ./test/integration/test-api-personapack-provider-switch.sh
-	bash ./test/integration/test-api-personapack-adhoc-correctness.sh
+	bash ./test/integration/test-api-ensemble-provider-switch.sh
+	bash ./test/integration/test-api-ensemble-adhoc-correctness.sh
 	bash ./test/integration/test-api-agentrun-container-shape.sh
-	bash ./test/integration/test-api-personapack-provisioning.sh
+	bash ./test/integration/test-api-ensemble-provisioning.sh
 	bash ./test/integration/test-api-schedule-dispatch.sh
 	bash ./test/integration/test-api-observability.sh
 	bash ./test/integration/test-api-web-endpoint.sh

README.md

@@ -48,7 +48,7 @@ curl -fsSL https://deploy.sympozium.ai/install.sh | sh
 Then deploy to your cluster and activate your first agents:
 
 ```bash
-sympozium install          # deploys CRDs, controllers, and built-in PersonaPacks
+sympozium install          # deploys CRDs, controllers, and built-in Ensembles
 sympozium                  # launch the TUI — go to Personas tab, press Enter to onboard
 sympozium serve            # open the web dashboard (port-forwards to the in-cluster UI)
 ```
@@ -82,7 +82,7 @@ Sympozium serves **two powerful use cases** on one Kubernetes-native platform:
 
 | | |
 |---|---|
-| **PersonaPacks** | Helm-like bundles for AI agent teams — activate a pack and the controller stamps out instances, schedules, and memory |
+| **Ensembles** | Helm-like bundles for AI agent teams — activate a pack and the controller stamps out instances, schedules, and memory |
 | **Agent Workflows** | Delegation, sequential pipelines, and supervision relationships between personas — visualised on an interactive canvas |
 | **Shared Workflow Memory** | Pack-level SQLite memory pool for cross-persona knowledge sharing with per-persona access control |
 | **Skill Sidecars** | Every skill runs in its own sidecar with ephemeral least-privilege RBAC, garbage-collected on completion |
@@ -103,7 +103,7 @@ Sympozium serves **two powerful use cases** on one Kubernetes-native platform:
 | Getting Started | [deploy.sympozium.ai/docs/getting-started](https://deploy.sympozium.ai/docs/getting-started/) |
 | Architecture | [deploy.sympozium.ai/docs/architecture](https://deploy.sympozium.ai/docs/architecture/) |
 | Custom Resources | [deploy.sympozium.ai/docs/concepts/custom-resources](https://deploy.sympozium.ai/docs/concepts/custom-resources/) |
-| PersonaPacks | [deploy.sympozium.ai/docs/concepts/personapacks](https://deploy.sympozium.ai/docs/concepts/personapacks/) |
+| Ensembles | [deploy.sympozium.ai/docs/concepts/ensembles](https://deploy.sympozium.ai/docs/concepts/ensembles/) |
 | Skills & Sidecars | [deploy.sympozium.ai/docs/concepts/skills](https://deploy.sympozium.ai/docs/concepts/skills/) |
 | Persistent Memory | [deploy.sympozium.ai/docs/concepts/persistent-memory](https://deploy.sympozium.ai/docs/concepts/persistent-memory/) |
 | Channels | [deploy.sympozium.ai/docs/concepts/channels](https://deploy.sympozium.ai/docs/concepts/channels/) |
@@ -117,7 +117,7 @@ Sympozium serves **two powerful use cases** on one Kubernetes-native platform:
 | LM Studio & Local Inference | [deploy.sympozium.ai/docs/guides/lm-studio](https://deploy.sympozium.ai/docs/guides/lm-studio/) |
 | llama-server | [deploy.sympozium.ai/docs/guides/llama-server](https://deploy.sympozium.ai/docs/guides/llama-server/) |
 | Unsloth | [deploy.sympozium.ai/docs/guides/unsloth](https://deploy.sympozium.ai/docs/guides/unsloth/) |
-| Writing PersonaPacks | [deploy.sympozium.ai/docs/guides/writing-personapacks](https://deploy.sympozium.ai/docs/guides/writing-personapacks/) |
+| Writing Ensembles | [deploy.sympozium.ai/docs/guides/writing-ensembles](https://deploy.sympozium.ai/docs/guides/writing-ensembles/) |
 | Your First AgentRun | [deploy.sympozium.ai/docs/guides/first-agentrun](https://deploy.sympozium.ai/docs/guides/first-agentrun/) |
 
 ---

api/v1alpha1/personapack_types.go api/v1alpha1/ensemble_types.goapi/v1alpha1/personapack_types.go renamed to api/v1alpha1/ensemble_types.go

@@ -4,29 +4,29 @@ import (
 	metav1 "k8s.io/apimachinery/pkg/apis/meta/v1"
 )
 
-// PersonaPackSpec defines a bundle of pre-configured agent personas.
-// Installing a PersonaPack stamps out SympoziumInstances, SympoziumSchedules,
+// EnsembleSpec defines a bundle of pre-configured agent personas.
+// Installing an Ensemble stamps out SympoziumInstances, SympoziumSchedules,
 // and optionally seeds memory for each persona.
-type PersonaPackSpec struct {
-	// Enabled controls whether the controller stamps out resources for this pack.
-	// PersonaPacks default to disabled (catalog-only) and must be explicitly
+type EnsembleSpec struct {
+	// Enabled controls whether the controller stamps out resources for this ensemble.
+	// Ensembles default to disabled (catalog-only) and must be explicitly
 	// activated — for example via the TUI or kubectl patch.
 	// +optional
 	Enabled bool `json:"enabled,omitempty"`
 
-	// Description is a human-readable summary of this persona pack.
+	// Description is a human-readable summary of this ensemble.
 	// +optional
 	Description string `json:"description,omitempty"`
 
-	// Category classifies this persona pack (e.g. "platform", "security", "devops").
+	// Category classifies this ensemble (e.g. "platform", "security", "devops").
 	// +optional
 	Category string `json:"category,omitempty"`
 
-	// Version is the persona pack version.
+	// Version is the ensemble version.
 	// +optional
 	Version string `json:"version,omitempty"`
 
-	// Personas is the list of agent personas in this pack.
+	// Personas is the list of agent personas in this ensemble.
 	Personas []PersonaSpec `json:"personas"`
 
 	// AuthRefs references secrets containing AI provider credentials.
@@ -77,24 +77,24 @@ type PersonaPackSpec struct {
 	ChannelAccessControl map[string]*ChannelAccessControl `json:"channelAccessControl,omitempty"`
 
 	// AgentSandbox configures the Kubernetes Agent Sandbox (CRD) execution backend
-	// for all instances generated by this pack. When enabled, agent runs use Sandbox
+	// for all instances generated by this ensemble. When enabled, agent runs use Sandbox
 	// CRs with gVisor/Kata kernel-level isolation.
 	// +optional
 	AgentSandbox *AgentSandboxInstanceSpec `json:"agentSandbox,omitempty"`
 
 	// SharedMemory configures a shared memory pool accessible to all personas
-	// in this pack. Each persona retains its private memory; the shared pool
+	// in this ensemble. Each persona retains its private memory; the shared pool
 	// provides cross-persona knowledge sharing within the workflow.
 	// +optional
 	SharedMemory *SharedMemorySpec `json:"sharedMemory,omitempty"`
 
-	// Relationships defines directed edges between personas in the pack,
+	// Relationships defines directed edges between personas in the ensemble,
 	// enabling coordination patterns like delegation, sequential pipelines,
 	// and supervision.
 	// +optional
 	Relationships []PersonaRelationship `json:"relationships,omitempty"`
 
-	// WorkflowType describes the overall orchestration pattern for this pack.
+	// WorkflowType describes the overall orchestration pattern for this ensemble.
 	// "autonomous" (default): personas run independently on their own schedules.
 	// "pipeline": personas execute in sequence defined by sequential edges.
 	// "delegation": personas can actively delegate to each other at runtime.
@@ -104,7 +104,7 @@ type PersonaPackSpec struct {
 	WorkflowType string `json:"workflowType,omitempty"`
 }
 
-// PersonaSpec defines a single agent persona within a PersonaPack.
+// PersonaSpec defines a single agent persona within an Ensemble.
 type PersonaSpec struct {
 	// Name is the persona identifier (used as suffix in generated instance names).
 	Name string `json:"name"`
@@ -117,7 +117,7 @@ type PersonaSpec struct {
 	SystemPrompt string `json:"systemPrompt"`
 
 	// Model overrides the default model for this persona.
-	// If empty, the pack-level or onboarding-time model is used.
+	// If empty, the ensemble-level or onboarding-time model is used.
 	// +optional
 	Model string `json:"model,omitempty"`
 
@@ -204,9 +204,9 @@ type PersonaMemory struct {
 	Seeds []string `json:"seeds,omitempty"`
 }
 
-// SharedMemorySpec configures a shared memory pool for all personas in a pack.
+// SharedMemorySpec configures a shared memory pool for all personas in an ensemble.
 type SharedMemorySpec struct {
-	// Enabled activates the shared memory server for this pack.
+	// Enabled activates the shared memory server for this ensemble.
 	// +kubebuilder:default=false
 	Enabled bool `json:"enabled"`
 
@@ -233,7 +233,7 @@ type SharedMemoryAccessRule struct {
 	Access string `json:"access"`
 }
 
-// PersonaRelationship defines a directed edge between two personas in a pack.
+// PersonaRelationship defines a directed edge between two personas in an ensemble.
 type PersonaRelationship struct {
 	// Source is the persona name that initiates the interaction.
 	Source string `json:"source"`
@@ -276,13 +276,13 @@ type InstalledPersona struct {
 	ScheduleName string `json:"scheduleName,omitempty"`
 }
 
-// PersonaPackStatus defines the observed state of PersonaPack.
-type PersonaPackStatus struct {
+// EnsembleStatus defines the observed state of Ensemble.
+type EnsembleStatus struct {
 	// Phase is the current phase (Pending, Ready, Error).
 	// +optional
 	Phase string `json:"phase,omitempty"`
 
-	// PersonaCount is the number of personas defined in this pack.
+	// PersonaCount is the number of personas defined in this ensemble.
 	// +optional
 	PersonaCount int `json:"personaCount,omitempty"`
 
@@ -312,26 +312,26 @@ type PersonaPackStatus struct {
 // +kubebuilder:printcolumn:name="Phase",type="string",JSONPath=".status.phase"
 // +kubebuilder:printcolumn:name="Age",type="date",JSONPath=".metadata.creationTimestamp"
 
-// PersonaPack is the Schema for the personapacks API.
+// Ensemble is the Schema for the ensembles API.
 // It bundles pre-configured agent personas that can be installed to stamp out
 // SympoziumInstances, Schedules, and memory seeds.
-type PersonaPack struct {
+type Ensemble struct {
 	metav1.TypeMeta   `json:",inline"`
 	metav1.ObjectMeta `json:"metadata,omitempty"`
 
-	Spec   PersonaPackSpec   `json:"spec,omitempty"`
-	Status PersonaPackStatus `json:"status,omitempty"`
+	Spec   EnsembleSpec   `json:"spec,omitempty"`
+	Status EnsembleStatus `json:"status,omitempty"`
 }
 
 // +kubebuilder:object:root=true
 
-// PersonaPackList contains a list of PersonaPack.
-type PersonaPackList struct {
+// EnsembleList contains a list of Ensemble.
+type EnsembleList struct {
 	metav1.TypeMeta `json:",inline"`
 	metav1.ListMeta `json:"metadata,omitempty"`
-	Items           []PersonaPack `json:"items"`
+	Items           []Ensemble `json:"items"`
 }
 
 func init() {
-	SchemeBuilder.Register(&PersonaPack{}, &PersonaPackList{})
+	SchemeBuilder.Register(&Ensemble{}, &EnsembleList{})
 }