[claude] feat: emergent narrative engine from agent interactions (#1607) (#1626)

Merged PR #1622: feat: add sovereign conversation artifacts slice

.gitea/branch-protection/the-nexus.yml

@@ -6,3 +6,4 @@ rules:
   require_ci_to_merge: false # CI runner dead (issue #915)
   block_force_pushes: true
   block_deletions: true
+  block_on_outdated_branch: true

.github/BRANCH_PROTECTION.md

@@ -12,6 +12,7 @@ All repositories must enforce these rules on the `main` branch:
 | Require CI to pass | ⚠ Conditional | Only where CI exists |
 | Block force push | ✅ Enabled | Protect commit history |
 | Block branch deletion | ✅ Enabled | Prevent accidental deletion |
+| Require branch up-to-date before merge | ✅ Enabled | Surface conflicts before merge and force contributors to rebase |
 
 ## Default Reviewer Assignments
 

agent/memory.py

@@ -285,6 +285,49 @@ class AgentMemory:
             logger.warning(f"Failed to store memory: {e}")
             return None
 
+    def remember_alexander_request_response(
+        self,
+        *,
+        request_text: str,
+        response_text: str,
+        requester: str = "Alexander Whitestone",
+        source: str = "",
+        metadata: Optional[dict] = None,
+    ) -> Optional[str]:
+        """Store an Alexander request + wizard response artifact in the sovereign room."""
+        if not self._check_available():
+            logger.warning("Cannot store Alexander artifact — MemPalace unavailable")
+            return None
+
+        try:
+            from nexus.mempalace.searcher import add_memory
+            from nexus.mempalace.conversation_artifacts import build_request_response_artifact
+
+            artifact = build_request_response_artifact(
+                requester=requester,
+                responder=self.agent_name,
+                request_text=request_text,
+                response_text=response_text,
+                source=source,
+            )
+            extra_metadata = dict(artifact.metadata)
+            if metadata:
+                extra_metadata.update(metadata)
+
+            doc_id = add_memory(
+                text=artifact.text,
+                room=artifact.room,
+                wing=self.wing,
+                palace_path=self.palace_path,
+                source_file=source,
+                extra_metadata=extra_metadata,
+            )
+            logger.debug("Stored Alexander request/response artifact in sovereign room")
+            return doc_id
+        except Exception as e:
+            logger.warning(f"Failed to store Alexander artifact: {e}")
+            return None
+
     def write_diary(
         self,
         summary: Optional[str] = None,

app.js

@@ -714,6 +714,10 @@ async function init() {
   camera = new THREE.PerspectiveCamera(65, window.innerWidth / window.innerHeight, 0.1, 1000);
   camera.position.copy(playerPos);
 
+  // Initialize avatar and LOD systems
+  if (window.AvatarCustomization) window.AvatarCustomization.init(scene, camera);
+  if (window.LODSystem) window.LODSystem.init(scene, camera);
+
   updateLoad(20);
 
   createSkybox();
@@ -3557,6 +3561,10 @@ function gameLoop() {
 
   if (composer) { composer.render(); } else { renderer.render(scene, camera); }
 
+  // Update avatar and LOD systems
+  if (window.AvatarCustomization && playerPos) window.AvatarCustomization.update(playerPos);
+  if (window.LODSystem && playerPos) window.LODSystem.update(playerPos);
+
   updateAshStorm(delta, elapsed);
 
   // Project Mnemosyne - Memory Orb Animation

config/mission_bus_profiles.json

@@ -1,34 +0,0 @@
-{
-  "roles": {
-    "lead": ["publish", "checkpoint", "handoff", "read", "audit", "configure_isolation"],
-    "write": ["publish", "checkpoint", "handoff", "read"],
-    "read": ["read"],
-    "audit": ["read", "audit"]
-  },
-  "isolation_profiles": [
-    {
-      "name": "level1-directory",
-      "label": "Level 1 — directory workspace",
-      "level": 1,
-      "mechanism": "directory_workspace",
-      "description": "Single mission cell in an isolated workspace directory.",
-      "supports_resume": true
-    },
-    {
-      "name": "level2-mount-namespace",
-      "label": "Level 2 — mount namespace",
-      "level": 2,
-      "mechanism": "mount_namespace",
-      "description": "Mount-namespace isolation with explicit mission-cell mounts.",
-      "supports_resume": true
-    },
-    {
-      "name": "level3-rootless-podman",
-      "label": "Level 3 — rootless Podman",
-      "level": 3,
-      "mechanism": "rootless_podman",
-      "description": "Rootless Podman cell for the strongest process and filesystem containment.",
-      "supports_resume": true
-    }
-  ]
-}

docs/mission-bus.md

@@ -1,31 +0,0 @@
-# Mission Bus
-
-The Mission Bus grounds the multi-agent teaming epic with a concrete, executable shared module.
-
-## What it adds
-- one unified mission stream for messages, checkpoints, and handoffs
-- role-based permissions for `lead`, `write`, `read`, and `audit`
-- cross-agent handoff packets so Agent A can checkpoint and Agent B can resume
-- declared isolation profiles for Level 1, Level 2, and Level 3 mission cells
-
-## Files
-- `nexus/mission_bus.py`
-- `config/mission_bus_profiles.json`
-
-## Example
-
-```python
-from nexus.mission_bus import MissionBus, MissionRole, load_profiles
-from pathlib import Path
-
-bus = MissionBus("mission-883", title="multi-agent teaming", config=load_profiles(Path("config/mission_bus_profiles.json")))
-bus.register_participant("timmy", MissionRole.LEAD)
-bus.register_participant("ezra", MissionRole.WRITE)
-checkpoint = bus.create_checkpoint("ezra", summary="checkpoint", state={"branch": "fix/883"})
-bus.handoff("ezra", "timmy", checkpoint.checkpoint_id, note="resume from here")
-packet = bus.build_resume_packet(bus.events[-1].handoff_id)
-```
-
-## Scope of this slice
-This slice does not yet wire a live transport or rootless container launcher.
-It codifies the mission bus contract, role permissions, handoff packet, and isolation profile surface so later work can execute against a stable interface.

index.html

@@ -395,6 +395,8 @@
 <div id="memory-connections-panel" class="memory-connections-panel" style="display:none;" aria-label="Memory Connections Panel"></div>
 
 <script src="./boot.js"></script>
+<script src="./avatar-customization.js"></script>
+<script src="./lod-system.js"></script>
 <script>
 function openMemoryFilter() { renderFilterList(); document.getElementById('memory-filter').style.display = 'flex'; }
 function closeMemoryFilter() { document.getElementById('memory-filter').style.display = 'none'; }

lod-system.js

@@ -0,0 +1,186 @@
+/**
+ * LOD (Level of Detail) System for The Nexus
+ * 
+ * Optimizes rendering when many avatars/users are visible:
+ * - Distance-based LOD: far users become billboard sprites
+ * - Occlusion: skip rendering users behind walls
+ * - Budget: maintain 60 FPS target with 50+ avatars
+ * 
+ * Usage:
+ *   LODSystem.init(scene, camera);
+ *   LODSystem.registerAvatar(avatarMesh, userId);
+ *   LODSystem.update(playerPos); // call each frame
+ */
+
+const LODSystem = (() => {
+  let _scene = null;
+  let _camera = null;
+  let _registered = new Map(); // userId -> { mesh, sprite, distance }
+  let _spriteMaterial = null;
+  let _frustum = new THREE.Frustum();
+  let _projScreenMatrix = new THREE.Matrix4();
+
+  // Thresholds
+  const LOD_NEAR = 15;      // Full mesh within 15 units
+  const LOD_FAR = 40;       // Billboard beyond 40 units
+  const LOD_CULL = 80;      // Don't render beyond 80 units
+  const SPRITE_SIZE = 1.2;
+
+  function init(sceneRef, cameraRef) {
+    _scene = sceneRef;
+    _camera = cameraRef;
+
+    // Create shared sprite material
+    const canvas = document.createElement('canvas');
+    canvas.width = 64;
+    canvas.height = 64;
+    const ctx = canvas.getContext('2d');
+    // Simple avatar indicator: colored circle
+    ctx.fillStyle = '#00ffcc';
+    ctx.beginPath();
+    ctx.arc(32, 32, 20, 0, Math.PI * 2);
+    ctx.fill();
+    ctx.fillStyle = '#0a0f1a';
+    ctx.beginPath();
+    ctx.arc(32, 28, 8, 0, Math.PI * 2); // head
+    ctx.fill();
+
+    const texture = new THREE.CanvasTexture(canvas);
+    _spriteMaterial = new THREE.SpriteMaterial({
+      map: texture,
+      transparent: true,
+      depthTest: true,
+      sizeAttenuation: true,
+    });
+
+    console.log('[LODSystem] Initialized');
+  }
+
+  function registerAvatar(avatarMesh, userId, color) {
+    // Create billboard sprite for this avatar
+    const spriteMat = _spriteMaterial.clone();
+    if (color) {
+      // Tint sprite to match avatar color
+      const canvas = document.createElement('canvas');
+      canvas.width = 64;
+      canvas.height = 64;
+      const ctx = canvas.getContext('2d');
+      ctx.fillStyle = color;
+      ctx.beginPath();
+      ctx.arc(32, 32, 20, 0, Math.PI * 2);
+      ctx.fill();
+      ctx.fillStyle = '#0a0f1a';
+      ctx.beginPath();
+      ctx.arc(32, 28, 8, 0, Math.PI * 2);
+      ctx.fill();
+      spriteMat.map = new THREE.CanvasTexture(canvas);
+      spriteMat.map.needsUpdate = true;
+    }
+
+    const sprite = new THREE.Sprite(spriteMat);
+    sprite.scale.set(SPRITE_SIZE, SPRITE_SIZE, 1);
+    sprite.visible = false;
+    _scene.add(sprite);
+
+    _registered.set(userId, {
+      mesh: avatarMesh,
+      sprite: sprite,
+      distance: Infinity,
+    });
+  }
+
+  function unregisterAvatar(userId) {
+    const entry = _registered.get(userId);
+    if (entry) {
+      _scene.remove(entry.sprite);
+      entry.sprite.material.dispose();
+      _registered.delete(userId);
+    }
+  }
+
+  function setSpriteColor(userId, color) {
+    const entry = _registered.get(userId);
+    if (!entry) return;
+    const canvas = document.createElement('canvas');
+    canvas.width = 64;
+    canvas.height = 64;
+    const ctx = canvas.getContext('2d');
+    ctx.fillStyle = color;
+    ctx.beginPath();
+    ctx.arc(32, 32, 20, 0, Math.PI * 2);
+    ctx.fill();
+    ctx.fillStyle = '#0a0f1a';
+    ctx.beginPath();
+    ctx.arc(32, 28, 8, 0, Math.PI * 2);
+    ctx.fill();
+    entry.sprite.material.map = new THREE.CanvasTexture(canvas);
+    entry.sprite.material.map.needsUpdate = true;
+  }
+
+  function update(playerPos) {
+    if (!_camera) return;
+
+    // Update frustum for culling
+    _projScreenMatrix.multiplyMatrices(
+      _camera.projectionMatrix,
+      _camera.matrixWorldInverse
+    );
+    _frustum.setFromProjectionMatrix(_projScreenMatrix);
+
+    _registered.forEach((entry, userId) => {
+      if (!entry.mesh) return;
+
+      const meshPos = entry.mesh.position;
+      const distance = playerPos.distanceTo(meshPos);
+      entry.distance = distance;
+
+      // Beyond cull distance: hide everything
+      if (distance > LOD_CULL) {
+        entry.mesh.visible = false;
+        entry.sprite.visible = false;
+        return;
+      }
+
+      // Check if in camera frustum
+      const inFrustum = _frustum.containsPoint(meshPos);
+      if (!inFrustum) {
+        entry.mesh.visible = false;
+        entry.sprite.visible = false;
+        return;
+      }
+
+      // LOD switching
+      if (distance <= LOD_NEAR) {
+        // Near: full mesh
+        entry.mesh.visible = true;
+        entry.sprite.visible = false;
+      } else if (distance <= LOD_FAR) {
+        // Mid: mesh with reduced detail (keep mesh visible)
+        entry.mesh.visible = true;
+        entry.sprite.visible = false;
+      } else {
+        // Far: billboard sprite
+        entry.mesh.visible = false;
+        entry.sprite.visible = true;
+        entry.sprite.position.copy(meshPos);
+        entry.sprite.position.y += 1.2; // above avatar center
+      }
+    });
+  }
+
+  function getStats() {
+    let meshCount = 0;
+    let spriteCount = 0;
+    let culledCount = 0;
+    _registered.forEach(entry => {
+      if (entry.mesh.visible) meshCount++;
+      else if (entry.sprite.visible) spriteCount++;
+      else culledCount++;
+    });
+    return { total: _registered.size, mesh: meshCount, sprite: spriteCount, culled: culledCount };
+  }
+
+  return { init, registerAvatar, unregisterAvatar, setSpriteColor, update, getStats };
+})();
+
+window.LODSystem = LODSystem;

mempalace/rooms.yaml

@@ -62,6 +62,15 @@ core_rooms:
       - proof-of-concept code snippets
       - benchmark data
 
+  - key: sovereign
+    label: Sovereign
+    purpose: Artifacts of Alexander Whitestone's requests, directives, and wizard responses
+    examples:
+      - dated request/response artifacts
+      - conversation summaries with speaker tags
+      - directive ledgers
+      - response follow-through notes
+
 optional_rooms:
   - key: evennia
     label: Evennia
@@ -98,15 +107,6 @@ optional_rooms:
     purpose: Catch-all for artefacts not yet assigned to a named room
     wizards: ["*"]
 
-  - key: sovereign
-    label: Sovereign
-    purpose: Artifacts of Alexander Whitestone's requests, directives, and conversation history
-    wizards: ["*"]
-    conventions:
-      naming: "YYYY-MM-DD_HHMMSS_<topic>.md"
-      index: "INDEX.md"
-      description: "Each artifact is a dated record of a request from Alexander and the wizard's response. The running INDEX.md provides a chronological catalog."
-
 # Tunnel routing table
 # Defines which room pairs are connected across wizard wings.
 # A tunnel lets `recall <query> --fleet` search both wings at once.

nexus/__init__.py

@@ -14,16 +14,7 @@ from nexus.perception_adapter import (
 )
 from nexus.experience_store import ExperienceStore
 from nexus.trajectory_logger import TrajectoryLogger
-from nexus.mission_bus import (
+from nexus.chronicle import ChronicleWriter, AgentEvent, EventKind
-    MissionBus,
-    MissionRole,
-    MissionParticipant,
-    MissionMessage,
-    MissionCheckpoint,
-    MissionHandoff,
-    IsolationProfile,
-    load_profiles,
-)
 
 try:
     from nexus.nexus_think import NexusMind
@@ -38,13 +29,8 @@ __all__ = [
     "Action",
     "ExperienceStore",
     "TrajectoryLogger",
-    "MissionBus",
-    "MissionRole",
-    "MissionParticipant",
-    "MissionMessage",
-    "MissionCheckpoint",
-    "MissionHandoff",
-    "IsolationProfile",
-    "load_profiles",
     "NexusMind",
+    "ChronicleWriter",
+    "AgentEvent",
+    "EventKind",
 ]

nexus/chronicle.py

@@ -0,0 +1,387 @@
+"""
+Nexus Chronicle — Emergent Narrative from Agent Interactions
+
+Watches the fleet's activity (dispatches, errors, recoveries,
+collaborations) and transforms raw event data into narrative prose.
+The system finds the dramatic arc in real work and produces a living
+chronicle. The story writes itself from the data.
+
+Usage:
+    from nexus.chronicle import ChronicleWriter, AgentEvent, EventKind
+
+    writer = ChronicleWriter()
+
+    writer.ingest(AgentEvent(kind=EventKind.DISPATCH, agent="claude", detail="took issue #42"))
+    writer.ingest(AgentEvent(kind=EventKind.ERROR, agent="claude", detail="rate limit hit"))
+    writer.ingest(AgentEvent(kind=EventKind.RECOVERY, agent="claude", detail="retried after backoff"))
+    writer.ingest(AgentEvent(kind=EventKind.COMMIT, agent="claude", detail="feat: add narrative engine"))
+
+    prose = writer.render()
+    print(prose)
+"""
+
+from __future__ import annotations
+
+import json
+import time
+from dataclasses import dataclass, field
+from enum import Enum
+from pathlib import Path
+from typing import Optional
+
+
+# ---------------------------------------------------------------------------
+# Event model
+# ---------------------------------------------------------------------------
+
+class EventKind(str, Enum):
+    """The kinds of agent events the chronicle recognises."""
+
+    DISPATCH = "dispatch"         # agent claimed / was assigned work
+    COMMIT = "commit"             # agent produced a commit
+    PUSH = "push"                 # agent pushed a branch
+    PR_OPEN = "pr_open"           # agent opened a pull request
+    PR_MERGE = "pr_merge"         # PR was merged
+    ERROR = "error"               # agent hit an error / exception
+    RECOVERY = "recovery"         # agent recovered from a failure
+    ABANDON = "abandon"           # agent abandoned a task (timeout / giving up)
+    COLLABORATION = "collab"      # two agents worked on the same thing
+    HEARTBEAT = "heartbeat"       # agent reported a heartbeat (alive signal)
+    IDLE = "idle"                 # agent is waiting for work
+    MILESTONE = "milestone"       # notable achievement (e.g. 100th issue closed)
+
+
+@dataclass
+class AgentEvent:
+    """One discrete thing that happened in the fleet."""
+
+    kind: EventKind
+    agent: str                          # who did this (e.g. "claude", "mimo-v2-pro")
+    detail: str = ""                    # free-text description
+    timestamp: float = field(default_factory=time.time)
+    metadata: dict = field(default_factory=dict)
+
+    def to_dict(self) -> dict:
+        return {
+            "kind": self.kind.value,
+            "agent": self.agent,
+            "detail": self.detail,
+            "timestamp": self.timestamp,
+            "metadata": self.metadata,
+        }
+
+    @classmethod
+    def from_dict(cls, data: dict) -> "AgentEvent":
+        return cls(
+            kind=EventKind(data["kind"]),
+            agent=data["agent"],
+            detail=data.get("detail", ""),
+            timestamp=data.get("timestamp", time.time()),
+            metadata=data.get("metadata", {}),
+        )
+
+
+# ---------------------------------------------------------------------------
+# Narrative templates — maps event kinds to prose fragments
+# ---------------------------------------------------------------------------
+
+# Each entry is a list so we can rotate through variants.
+_TEMPLATES: dict[EventKind, list[str]] = {
+    EventKind.DISPATCH: [
+        "{agent} stepped forward and claimed the work: {detail}.",
+        "{agent} took on the challenge — {detail}.",
+        "The task landed on {agent}'s desk: {detail}.",
+    ],
+    EventKind.COMMIT: [
+        '{agent} sealed a commit into the record: "{detail}".',
+        '{agent} committed "{detail}" — progress crystallised.',
+        "{agent} carved a new ring into the trunk: {detail}.",
+    ],
+    EventKind.PUSH: [
+        "{agent} pushed the work upstream.",
+        "The branch rose into the forge — {agent}'s changes were live.",
+        "{agent} sent their work into the wider current.",
+    ],
+    EventKind.PR_OPEN: [
+        "{agent} opened a pull request: {detail}.",
+        "A proposal surfaced — {agent} asked the fleet to review {detail}.",
+        "{agent} laid their work before the reviewers: {detail}.",
+    ],
+    EventKind.PR_MERGE: [
+        "{agent}'s branch folded into the whole: {detail}.",
+        "Consensus reached — {agent}'s changes were merged: {detail}.",
+        "{detail} joined the canon. {agent}'s contribution lives on.",
+    ],
+    EventKind.ERROR: [
+        "{agent} ran into an obstacle: {detail}.",
+        "Trouble. {agent} encountered {detail} and had to pause.",
+        "The path grew difficult — {agent} hit {detail}.",
+    ],
+    EventKind.RECOVERY: [
+        "{agent} regrouped and pressed on: {detail}.",
+        "After the setback, {agent} found a way through: {detail}.",
+        "{agent} recovered — {detail}.",
+    ],
+    EventKind.ABANDON: [
+        "{agent} released the task, unable to finish: {detail}.",
+        "Sometimes wisdom is knowing when to let go. {agent} abandoned {detail}.",
+        "{agent} stepped back from {detail}. Another will carry it forward.",
+    ],
+    EventKind.COLLABORATION: [
+        "{agent} and their peers converged on the same problem: {detail}.",
+        "Two minds touched the same work — {agent} in collaboration: {detail}.",
+        "The fleet coordinated — {agent} joined the effort on {detail}.",
+    ],
+    EventKind.HEARTBEAT: [
+        "{agent} checked in — still thinking, still present.",
+        "A pulse from {agent}: the mind is alive.",
+        "{agent} breathed through another cycle.",
+    ],
+    EventKind.IDLE: [
+        "{agent} rested, waiting for the next call.",
+        "Quiet descended — {agent} held still between tasks.",
+        "{agent} stood ready, watchful in the lull.",
+    ],
+    EventKind.MILESTONE: [
+        "A moment worth noting — {agent}: {detail}.",
+        "The chronicle marks a milestone. {agent}: {detail}.",
+        "History ticked over — {agent} reached {detail}.",
+    ],
+}
+
+# Arc-level commentary triggered by sequences of events
+_ARC_TEMPLATES = {
+    "struggle_and_recovery": (
+        "There was a struggle here. {agent} hit trouble and came back stronger — "
+        "the kind of arc that gives a chronicle its texture."
+    ),
+    "silent_grind": (
+        "No drama, just steady work. {agents} moved through the backlog with quiet persistence."
+    ),
+    "abandon_then_retry": (
+        "{agent} let go once. But the work called again, and this time it was answered."
+    ),
+    "solo_sprint": (
+        "{agent} ran the whole arc alone — dispatch to merge — without breaking stride."
+    ),
+    "fleet_convergence": (
+        "The fleet converged. Multiple agents touched the same thread and wove it tighter."
+    ),
+}
+
+
+# ---------------------------------------------------------------------------
+# Chronicle writer
+# ---------------------------------------------------------------------------
+
+class ChronicleWriter:
+    """Accumulates agent events and renders them as narrative prose.
+
+    The writer keeps a running log of events.  Call ``ingest()`` to add new
+    events as they arrive, then ``render()`` to produce a prose snapshot of
+    the current arc.
+
+    Events are also persisted to JSONL so the chronicle survives restarts.
+    """
+
+    def __init__(self, log_path: Optional[Path] = None):
+        today = time.strftime("%Y-%m-%d")
+        self.log_path = log_path or (
+            Path.home() / ".nexus" / "chronicle" / f"chronicle_{today}.jsonl"
+        )
+        self.log_path.parent.mkdir(parents=True, exist_ok=True)
+
+        self._events: list[AgentEvent] = []
+        self._template_counters: dict[EventKind, int] = {}
+
+        # Load any events already on disk for today
+        self._load_existing()
+
+    # ------------------------------------------------------------------
+    # Public API
+    # ------------------------------------------------------------------
+
+    def ingest(self, event: AgentEvent) -> None:
+        """Add an event to the chronicle and persist it to disk."""
+        self._events.append(event)
+        with open(self.log_path, "a") as f:
+            f.write(json.dumps(event.to_dict()) + "\n")
+
+    def render(self, max_events: int = 50) -> str:
+        """Render the recent event stream as narrative prose.
+
+        Returns a multi-paragraph string suitable for display or logging.
+        """
+        events = self._events[-max_events:]
+        if not events:
+            return "The chronicle is empty. No events have been recorded yet."
+
+        paragraphs: list[str] = []
+
+        # Opening line with timestamp range
+        first_ts = time.strftime("%H:%M", time.localtime(events[0].timestamp))
+        last_ts = time.strftime("%H:%M", time.localtime(events[-1].timestamp))
+        paragraphs.append(
+            f"The chronicle covers {len(events)} event(s) between {first_ts} and {last_ts}."
+        )
+
+        # Event-by-event prose
+        sentences: list[str] = []
+        for evt in events:
+            sentences.append(self._render_event(evt))
+        paragraphs.append("  ".join(sentences))
+
+        # Arc-level commentary
+        arc = self._detect_arc(events)
+        if arc:
+            paragraphs.append(arc)
+
+        return "\n\n".join(paragraphs)
+
+    def render_markdown(self, max_events: int = 50) -> str:
+        """Render as a Markdown document."""
+        events = self._events[-max_events:]
+        if not events:
+            return "# Chronicle\n\n*No events recorded yet.*"
+
+        today = time.strftime("%Y-%m-%d")
+        lines = [f"# Chronicle — {today}", ""]
+
+        for evt in events:
+            ts = time.strftime("%H:%M:%S", time.localtime(evt.timestamp))
+            prose = self._render_event(evt)
+            lines.append(f"**{ts}** — {prose}")
+
+        arc = self._detect_arc(events)
+        if arc:
+            lines += ["", "---", "", f"*{arc}*"]
+
+        return "\n".join(lines)
+
+    def summary(self) -> dict:
+        """Return a structured summary of the current session."""
+        agents: dict[str, dict] = {}
+        kind_counts: dict[str, int] = {}
+
+        for evt in self._events:
+            agents.setdefault(evt.agent, {"events": 0, "kinds": []})
+            agents[evt.agent]["events"] += 1
+            agents[evt.agent]["kinds"].append(evt.kind.value)
+            kind_counts[evt.kind.value] = kind_counts.get(evt.kind.value, 0) + 1
+
+        return {
+            "total_events": len(self._events),
+            "agents": agents,
+            "kind_counts": kind_counts,
+            "log_path": str(self.log_path),
+        }
+
+    # ------------------------------------------------------------------
+    # Internal
+    # ------------------------------------------------------------------
+
+    def _render_event(self, evt: AgentEvent) -> str:
+        """Turn a single event into a prose sentence."""
+        templates = _TEMPLATES.get(evt.kind, ["{agent}: {detail}"])
+        counter = self._template_counters.get(evt.kind, 0)
+        template = templates[counter % len(templates)]
+        self._template_counters[evt.kind] = counter + 1
+        return template.format(agent=evt.agent, detail=evt.detail or evt.kind.value)
+
+    def _detect_arc(self, events: list[AgentEvent]) -> Optional[str]:
+        """Scan the event sequence for a recognisable dramatic arc."""
+        if not events:
+            return None
+
+        kinds = [e.kind for e in events]
+        agents = list({e.agent for e in events})
+
+        # struggle → recovery
+        if EventKind.ERROR in kinds and EventKind.RECOVERY in kinds:
+            err_idx = kinds.index(EventKind.ERROR)
+            rec_idx = kinds.index(EventKind.RECOVERY)
+            if rec_idx > err_idx:
+                agent = events[err_idx].agent
+                return _ARC_TEMPLATES["struggle_and_recovery"].format(agent=agent)
+
+        # abandon → dispatch (retry): find first ABANDON, then any DISPATCH after it
+        if EventKind.ABANDON in kinds and EventKind.DISPATCH in kinds:
+            ab_idx = kinds.index(EventKind.ABANDON)
+            retry_idx = next(
+                (i for i, k in enumerate(kinds) if k == EventKind.DISPATCH and i > ab_idx),
+                None,
+            )
+            if retry_idx is not None:
+                agent = events[retry_idx].agent
+                return _ARC_TEMPLATES["abandon_then_retry"].format(agent=agent)
+
+        # solo sprint: single agent goes dispatch→commit→pr_open→pr_merge
+        solo_arc = {EventKind.DISPATCH, EventKind.COMMIT, EventKind.PR_OPEN, EventKind.PR_MERGE}
+        if solo_arc.issubset(set(kinds)) and len(agents) == 1:
+            return _ARC_TEMPLATES["solo_sprint"].format(agent=agents[0])
+
+        # fleet convergence: multiple agents, collaboration event
+        if len(agents) > 1 and EventKind.COLLABORATION in kinds:
+            return _ARC_TEMPLATES["fleet_convergence"]
+
+        # silent grind: only commits / heartbeats, no drama
+        drama = {EventKind.ERROR, EventKind.ABANDON, EventKind.RECOVERY, EventKind.COLLABORATION}
+        if not drama.intersection(set(kinds)) and EventKind.COMMIT in kinds:
+            return _ARC_TEMPLATES["silent_grind"].format(agents=", ".join(agents))
+
+        return None
+
+    def _load_existing(self) -> None:
+        """Load events persisted from earlier in the same session."""
+        if not self.log_path.exists():
+            return
+        with open(self.log_path) as f:
+            for line in f:
+                line = line.strip()
+                if not line:
+                    continue
+                try:
+                    self._events.append(AgentEvent.from_dict(json.loads(line)))
+                except (json.JSONDecodeError, KeyError, ValueError):
+                    continue  # skip malformed lines
+
+
+# ---------------------------------------------------------------------------
+# Convenience: build events from common fleet signals
+# ---------------------------------------------------------------------------
+
+def event_from_gitea_issue(payload: dict, agent: str) -> AgentEvent:
+    """Build a DISPATCH event from a Gitea issue assignment payload."""
+    issue_num = payload.get("number", "?")
+    title = payload.get("title", "")
+    return AgentEvent(
+        kind=EventKind.DISPATCH,
+        agent=agent,
+        detail=f"issue #{issue_num}: {title}",
+        metadata={"issue_number": issue_num},
+    )
+
+
+def event_from_heartbeat(hb: dict) -> AgentEvent:
+    """Build a HEARTBEAT event from a nexus heartbeat dict."""
+    agent = hb.get("model", "unknown")
+    status = hb.get("status", "thinking")
+    cycle = hb.get("cycle", 0)
+    return AgentEvent(
+        kind=EventKind.HEARTBEAT,
+        agent=agent,
+        detail=f"cycle {cycle}, status={status}",
+        metadata=hb,
+    )
+
+
+def event_from_commit(commit: dict, agent: str) -> AgentEvent:
+    """Build a COMMIT event from a git commit dict."""
+    message = commit.get("message", "").split("\n")[0]  # subject line only
+    sha = commit.get("sha", "")[:8]
+    return AgentEvent(
+        kind=EventKind.COMMIT,
+        agent=agent,
+        detail=message,
+        metadata={"sha": sha},
+    )

nexus/mempalace/__init__.py

@@ -13,6 +13,12 @@ from __future__ import annotations
 
 from nexus.mempalace.config import MEMPALACE_PATH, FLEET_WING
 from nexus.mempalace.searcher import search_memories, add_memory, MemPalaceResult
+from nexus.mempalace.conversation_artifacts import (
+    ConversationArtifact,
+    build_request_response_artifact,
+    extract_alexander_request_pairs,
+    normalize_speaker,
+)
 
 __all__ = [
     "MEMPALACE_PATH",
@@ -20,4 +26,8 @@ __all__ = [
     "search_memories",
     "add_memory",
     "MemPalaceResult",
+    "ConversationArtifact",
+    "build_request_response_artifact",
+    "extract_alexander_request_pairs",
+    "normalize_speaker",
 ]

nexus/mempalace/config.py

@@ -40,6 +40,7 @@ CORE_ROOMS: list[str] = [
     "nexus",       # reports, docs, KT
     "issues",      # tickets, backlog
     "experiments", # prototypes, spikes
+    "sovereign",   # Alexander request/response artifacts
 ]
 
 # ── ChromaDB collection name ──────────────────────────────────────────────────

nexus/mempalace/conversation_artifacts.py

@@ -0,0 +1,122 @@
+"""Helpers for preserving Alexander request/response artifacts in MemPalace.
+
+This module provides a small, typed bridge between raw conversation turns and
+MemPalace drawers stored in the shared `sovereign` room. The goal is not to
+solve all future speaker-tagging needs at once; it gives the Nexus one
+canonical artifact shape that other miners and bridges can reuse.
+"""
+
+from __future__ import annotations
+
+from dataclasses import dataclass, field
+from datetime import datetime, timezone
+from typing import Iterable
+
+_ALEXANDER_ALIASES = {
+    "alexander",
+    "alexander whitestone",
+    "rockachopa",
+    "triptimmy",
+}
+
+
+@dataclass(frozen=True)
+class ConversationArtifact:
+    requester: str
+    responder: str
+    request_text: str
+    response_text: str
+    room: str = "sovereign"
+    timestamp: str = field(default_factory=lambda: datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ"))
+    metadata: dict = field(default_factory=dict)
+
+    @property
+    def text(self) -> str:
+        return (
+            f"# Conversation Artifact\n\n"
+            f"## Alexander Request\n{self.request_text.strip()}\n\n"
+            f"## Wizard Response\n{self.response_text.strip()}\n"
+        )
+
+
+def normalize_speaker(name: str | None) -> str:
+    cleaned = " ".join((name or "").strip().lower().split())
+    if cleaned in _ALEXANDER_ALIASES:
+        return "alexander"
+    return cleaned.replace(" ", "_") or "unknown"
+
+
+def build_request_response_artifact(
+    *,
+    requester: str,
+    responder: str,
+    request_text: str,
+    response_text: str,
+    source: str = "",
+    timestamp: str | None = None,
+    request_timestamp: str | None = None,
+    response_timestamp: str | None = None,
+) -> ConversationArtifact:
+    requester_slug = normalize_speaker(requester)
+    responder_slug = normalize_speaker(responder)
+    ts = timestamp or datetime.now(timezone.utc).strftime("%Y-%m-%dT%H:%M:%SZ")
+    metadata = {
+        "artifact_type": "alexander_request_response",
+        "requester": requester_slug,
+        "responder": responder_slug,
+        "speaker_tags": [f"speaker:{requester_slug}", f"speaker:{responder_slug}"],
+        "source": source,
+        "timestamp": ts,
+    }
+    if request_timestamp:
+        metadata["request_timestamp"] = request_timestamp
+    if response_timestamp:
+        metadata["response_timestamp"] = response_timestamp
+    return ConversationArtifact(
+        requester=requester_slug,
+        responder=responder_slug,
+        request_text=request_text,
+        response_text=response_text,
+        timestamp=ts,
+        metadata=metadata,
+    )
+
+
+def extract_alexander_request_pairs(
+    turns: Iterable[dict],
+    *,
+    responder: str,
+    source: str = "",
+) -> list[ConversationArtifact]:
+    responder_slug = normalize_speaker(responder)
+    pending_request: dict | None = None
+    artifacts: list[ConversationArtifact] = []
+
+    for turn in turns:
+        speaker = normalize_speaker(
+            turn.get("speaker") or turn.get("username") or turn.get("author") or turn.get("name")
+        )
+        text = (turn.get("text") or turn.get("content") or "").strip()
+        if not text:
+            continue
+
+        if speaker == "alexander":
+            pending_request = turn
+            continue
+
+        if speaker == responder_slug and pending_request is not None:
+            artifacts.append(
+                build_request_response_artifact(
+                    requester="alexander",
+                    responder=responder_slug,
+                    request_text=(pending_request.get("text") or pending_request.get("content") or "").strip(),
+                    response_text=text,
+                    source=source,
+                    request_timestamp=pending_request.get("timestamp"),
+                    response_timestamp=turn.get("timestamp"),
+                    timestamp=turn.get("timestamp") or pending_request.get("timestamp"),
+                )
+            )
+            pending_request = None
+
+    return artifacts

nexus/mission_bus.py

@@ -1,358 +0,0 @@
-"""Mission bus, role permissions, cross-agent handoff, and isolation profiles.
-
-Grounded implementation slice for #883.
-The bus gives a single mission cell a unified event stream, permission-checked
-roles, checkpoint + resume handoff, and declared isolation profiles for Level
-1/2/3 execution boundaries.
-"""
-
-from __future__ import annotations
-
-import json
-import uuid
-from dataclasses import dataclass, field
-from datetime import datetime, timezone
-from enum import Enum
-from pathlib import Path
-from typing import Any, Dict, List, Union
-
-
-DEFAULT_CONFIG = {
-    "roles": {
-        "lead": ["publish", "checkpoint", "handoff", "read", "audit", "configure_isolation"],
-        "write": ["publish", "checkpoint", "handoff", "read"],
-        "read": ["read"],
-        "audit": ["read", "audit"],
-    },
-    "isolation_profiles": [
-        {
-            "name": "level1-directory",
-            "label": "Level 1 — directory workspace",
-            "level": 1,
-            "mechanism": "directory_workspace",
-            "description": "Single mission cell in an isolated workspace directory.",
-            "supports_resume": True,
-        },
-        {
-            "name": "level2-mount-namespace",
-            "label": "Level 2 — mount namespace",
-            "level": 2,
-            "mechanism": "mount_namespace",
-            "description": "Mount-namespace isolation with explicit mission-cell mounts.",
-            "supports_resume": True,
-        },
-        {
-            "name": "level3-rootless-podman",
-            "label": "Level 3 — rootless Podman",
-            "level": 3,
-            "mechanism": "rootless_podman",
-            "description": "Rootless Podman cell for the strongest process and filesystem containment.",
-            "supports_resume": True,
-        },
-    ],
-}
-
-
-def utcnow_iso() -> str:
-    return datetime.now(timezone.utc).isoformat()
-
-
-def load_profiles(path: Path) -> Dict[str, Any]:
-    if not path.exists():
-        return json.loads(json.dumps(DEFAULT_CONFIG))
-    with open(path, "r", encoding="utf-8") as handle:
-        data = json.load(handle)
-    data.setdefault("roles", DEFAULT_CONFIG["roles"])
-    data.setdefault("isolation_profiles", DEFAULT_CONFIG["isolation_profiles"])
-    return data
-
-
-class MissionRole(str, Enum):
-    LEAD = "lead"
-    WRITE = "write"
-    READ = "read"
-    AUDIT = "audit"
-
-
-@dataclass
-class IsolationProfile:
-    name: str
-    label: str
-    level: int
-    mechanism: str
-    description: str = ""
-    supports_resume: bool = True
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "name": self.name,
-            "label": self.label,
-            "level": self.level,
-            "mechanism": self.mechanism,
-            "description": self.description,
-            "supports_resume": self.supports_resume,
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "IsolationProfile":
-        return cls(
-            name=data["name"],
-            label=data["label"],
-            level=int(data["level"]),
-            mechanism=data["mechanism"],
-            description=data.get("description", ""),
-            supports_resume=bool(data.get("supports_resume", True)),
-        )
-
-
-@dataclass
-class MissionParticipant:
-    name: str
-    role: MissionRole
-    metadata: Dict[str, Any] = field(default_factory=dict)
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "name": self.name,
-            "role": self.role.value,
-            "metadata": self.metadata,
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "MissionParticipant":
-        return cls(name=data["name"], role=MissionRole(data["role"]), metadata=data.get("metadata", {}))
-
-
-@dataclass
-class MissionMessage:
-    sender: str
-    topic: str
-    payload: Dict[str, Any]
-    sequence: int
-    timestamp: str = field(default_factory=utcnow_iso)
-    message_id: str = field(default_factory=lambda: str(uuid.uuid4()))
-    event_type: str = field(default="message", init=False)
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "event_type": self.event_type,
-            "sender": self.sender,
-            "topic": self.topic,
-            "payload": self.payload,
-            "sequence": self.sequence,
-            "timestamp": self.timestamp,
-            "message_id": self.message_id,
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "MissionMessage":
-        return cls(
-            sender=data["sender"],
-            topic=data["topic"],
-            payload=data["payload"],
-            sequence=int(data["sequence"]),
-            timestamp=data.get("timestamp", utcnow_iso()),
-            message_id=data.get("message_id") or data.get("messageId") or str(uuid.uuid4()),
-        )
-
-
-@dataclass
-class MissionCheckpoint:
-    sender: str
-    summary: str
-    state: Dict[str, Any]
-    sequence: int
-    artifacts: List[str] = field(default_factory=list)
-    timestamp: str = field(default_factory=utcnow_iso)
-    checkpoint_id: str = field(default_factory=lambda: str(uuid.uuid4()))
-    event_type: str = field(default="checkpoint", init=False)
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "event_type": self.event_type,
-            "sender": self.sender,
-            "summary": self.summary,
-            "state": self.state,
-            "artifacts": self.artifacts,
-            "sequence": self.sequence,
-            "timestamp": self.timestamp,
-            "checkpoint_id": self.checkpoint_id,
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "MissionCheckpoint":
-        return cls(
-            sender=data["sender"],
-            summary=data["summary"],
-            state=data.get("state", {}),
-            artifacts=list(data.get("artifacts", [])),
-            sequence=int(data["sequence"]),
-            timestamp=data.get("timestamp", utcnow_iso()),
-            checkpoint_id=data.get("checkpoint_id") or data.get("checkpointId") or str(uuid.uuid4()),
-        )
-
-
-@dataclass
-class MissionHandoff:
-    sender: str
-    recipient: str
-    checkpoint_id: str
-    sequence: int
-    note: str = ""
-    timestamp: str = field(default_factory=utcnow_iso)
-    handoff_id: str = field(default_factory=lambda: str(uuid.uuid4()))
-    event_type: str = field(default="handoff", init=False)
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "event_type": self.event_type,
-            "sender": self.sender,
-            "recipient": self.recipient,
-            "checkpoint_id": self.checkpoint_id,
-            "note": self.note,
-            "sequence": self.sequence,
-            "timestamp": self.timestamp,
-            "handoff_id": self.handoff_id,
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "MissionHandoff":
-        return cls(
-            sender=data["sender"],
-            recipient=data["recipient"],
-            checkpoint_id=data["checkpoint_id"] if "checkpoint_id" in data else data["checkpointId"],
-            note=data.get("note", ""),
-            sequence=int(data["sequence"]),
-            timestamp=data.get("timestamp", utcnow_iso()),
-            handoff_id=data.get("handoff_id") or data.get("handoffId") or str(uuid.uuid4()),
-        )
-
-
-MissionEvent = Union[MissionMessage, MissionCheckpoint, MissionHandoff]
-
-
-def event_from_dict(data: Dict[str, Any]) -> MissionEvent:
-    kind = data["event_type"]
-    if kind == "message":
-        return MissionMessage.from_dict(data)
-    if kind == "checkpoint":
-        return MissionCheckpoint.from_dict(data)
-    if kind == "handoff":
-        return MissionHandoff.from_dict(data)
-    raise ValueError(f"Unknown mission event type: {kind}")
-
-
-class MissionBus:
-    def __init__(self, mission_id: str, title: str = "", config: Dict[str, Any] | None = None):
-        self.mission_id = mission_id
-        self.title = title
-        self.config = config or json.loads(json.dumps(DEFAULT_CONFIG))
-        self.role_permissions = {
-            role: set(perms) for role, perms in self.config.get("roles", {}).items()
-        }
-        self.isolation_profiles = [
-            IsolationProfile.from_dict(entry) for entry in self.config.get("isolation_profiles", [])
-        ]
-        self.participants: Dict[str, MissionParticipant] = {}
-        self.events: List[MissionEvent] = []
-
-    def register_participant(self, name: str, role: MissionRole, metadata: Dict[str, Any] | None = None) -> MissionParticipant:
-        participant = MissionParticipant(name=name, role=role, metadata=metadata or {})
-        self.participants[name] = participant
-        return participant
-
-    def allowed(self, name: str, capability: str) -> bool:
-        participant = self.participants.get(name)
-        if participant is None:
-            return False
-        return capability in self.role_permissions.get(participant.role.value, set())
-
-    def _require(self, name: str, capability: str) -> None:
-        if not self.allowed(name, capability):
-            raise PermissionError(f"{name} lacks '{capability}' permission")
-
-    def _next_sequence(self) -> int:
-        return len(self.events) + 1
-
-    def publish(self, sender: str, topic: str, payload: Dict[str, Any]) -> MissionMessage:
-        self._require(sender, "publish")
-        event = MissionMessage(sender=sender, topic=topic, payload=payload, sequence=self._next_sequence())
-        self.events.append(event)
-        return event
-
-    def create_checkpoint(
-        self,
-        sender: str,
-        summary: str,
-        state: Dict[str, Any],
-        artifacts: List[str] | None = None,
-    ) -> MissionCheckpoint:
-        self._require(sender, "checkpoint")
-        event = MissionCheckpoint(
-            sender=sender,
-            summary=summary,
-            state=state,
-            artifacts=list(artifacts or []),
-            sequence=self._next_sequence(),
-        )
-        self.events.append(event)
-        return event
-
-    def _get_checkpoint(self, checkpoint_id: str) -> MissionCheckpoint:
-        for event in self.events:
-            if isinstance(event, MissionCheckpoint) and event.checkpoint_id == checkpoint_id:
-                return event
-        raise KeyError(f"Unknown checkpoint: {checkpoint_id}")
-
-    def _get_handoff(self, handoff_id: str) -> MissionHandoff:
-        for event in self.events:
-            if isinstance(event, MissionHandoff) and event.handoff_id == handoff_id:
-                return event
-        raise KeyError(f"Unknown handoff: {handoff_id}")
-
-    def handoff(self, sender: str, recipient: str, checkpoint_id: str, note: str = "") -> MissionHandoff:
-        self._require(sender, "handoff")
-        if recipient not in self.participants:
-            raise KeyError(f"Unknown recipient: {recipient}")
-        self._get_checkpoint(checkpoint_id)
-        event = MissionHandoff(
-            sender=sender,
-            recipient=recipient,
-            checkpoint_id=checkpoint_id,
-            note=note,
-            sequence=self._next_sequence(),
-        )
-        self.events.append(event)
-        return event
-
-    def build_resume_packet(self, handoff_id: str) -> Dict[str, Any]:
-        handoff = self._get_handoff(handoff_id)
-        checkpoint = self._get_checkpoint(handoff.checkpoint_id)
-        return {
-            "mission_id": self.mission_id,
-            "title": self.title,
-            "recipient": handoff.recipient,
-            "sender": handoff.sender,
-            "handoff_note": handoff.note,
-            "checkpoint": checkpoint.to_dict(),
-            "participants": {name: participant.to_dict() for name, participant in self.participants.items()},
-            "isolation_profiles": [profile.to_dict() for profile in self.isolation_profiles],
-            "stream_length": len(self.events),
-        }
-
-    def to_dict(self) -> Dict[str, Any]:
-        return {
-            "mission_id": self.mission_id,
-            "title": self.title,
-            "config": self.config,
-            "participants": {name: participant.to_dict() for name, participant in self.participants.items()},
-            "events": [event.to_dict() for event in self.events],
-        }
-
-    @classmethod
-    def from_dict(cls, data: Dict[str, Any]) -> "MissionBus":
-        bus = cls(data["mission_id"], title=data.get("title", ""), config=data.get("config"))
-        for name, participant_data in data.get("participants", {}).items():
-            bus.participants[name] = MissionParticipant.from_dict(participant_data)
-        bus.events = [event_from_dict(event_data) for event_data in data.get("events", [])]
-        return bus

scripts/sync_branch_protection.py

@@ -4,48 +4,61 @@ Sync branch protection rules from .gitea/branch-protection/*.yml to Gitea.
 Correctly uses the Gitea 1.25+ API (not GitHub-style).
 """
 
+from __future__ import annotations
+
+import json
 import os
 import sys
-import json
 import urllib.request
+from pathlib import Path
+
 import yaml
 
 GITEA_URL = os.getenv("GITEA_URL", "https://forge.alexanderwhitestone.com")
 GITEA_TOKEN = os.getenv("GITEA_TOKEN", "")
 ORG = "Timmy_Foundation"
-CONFIG_DIR = ".gitea/branch-protection"
+PROJECT_ROOT = Path(__file__).resolve().parent.parent
+CONFIG_DIR = PROJECT_ROOT / ".gitea" / "branch-protection"
 
 
 def api_request(method: str, path: str, payload: dict | None = None) -> dict:
     url = f"{GITEA_URL}/api/v1{path}"
     data = json.dumps(payload).encode() if payload else None
-    req = urllib.request.Request(url, data=data, method=method, headers={
+    req = urllib.request.Request(
-        "Authorization": f"token {GITEA_TOKEN}",
+        url,
-        "Content-Type": "application/json",
+        data=data,
-    })
+        method=method,
+        headers={
+            "Authorization": f"token {GITEA_TOKEN}",
+            "Content-Type": "application/json",
+        },
+    )
     with urllib.request.urlopen(req, timeout=30) as resp:
         return json.loads(resp.read().decode())
 
 
-def apply_protection(repo: str, rules: dict) -> bool:
+def build_branch_protection_payload(branch: str, rules: dict) -> dict:
-    branch = rules.pop("branch", "main")
+    return {
-    # Check if protection already exists
-    existing = api_request("GET", f"/repos/{ORG}/{repo}/branch_protections")
-    exists = any(r.get("branch_name") == branch for r in existing)
-
-    payload = {
         "branch_name": branch,
         "rule_name": branch,
         "required_approvals": rules.get("required_approvals", 1),
         "block_on_rejected_reviews": rules.get("block_on_rejected_reviews", True),
         "dismiss_stale_approvals": rules.get("dismiss_stale_approvals", True),
         "block_deletions": rules.get("block_deletions", True),
-        "block_force_push": rules.get("block_force_push", True),
+        "block_force_push": rules.get("block_force_push", rules.get("block_force_pushes", True)),
         "block_admin_merge_override": rules.get("block_admin_merge_override", True),
         "enable_status_check": rules.get("require_ci_to_merge", False),
         "status_check_contexts": rules.get("status_check_contexts", []),
+        "block_on_outdated_branch": rules.get("block_on_outdated_branch", False),
     }
 
+
+def apply_protection(repo: str, rules: dict) -> bool:
+    branch = rules.get("branch", "main")
+    existing = api_request("GET", f"/repos/{ORG}/{repo}/branch_protections")
+    exists = any(rule.get("branch_name") == branch for rule in existing)
+    payload = build_branch_protection_payload(branch, rules)
+
     try:
         if exists:
             api_request("PATCH", f"/repos/{ORG}/{repo}/branch_protections/{branch}", payload)
@@ -53,8 +66,8 @@ def apply_protection(repo: str, rules: dict) -> bool:
             api_request("POST", f"/repos/{ORG}/{repo}/branch_protections", payload)
         print(f"✅ {repo}:{branch} synced")
         return True
-    except Exception as e:
+    except Exception as exc:
-        print(f"❌ {repo}:{branch} failed: {e}")
+        print(f"❌ {repo}:{branch} failed: {exc}")
         return False
 
 
@@ -62,15 +75,18 @@ def main() -> int:
     if not GITEA_TOKEN:
         print("ERROR: GITEA_TOKEN not set")
         return 1
+    if not CONFIG_DIR.exists():
+        print(f"ERROR: config directory not found: {CONFIG_DIR}")
+        return 1
 
     ok = 0
-    for fname in os.listdir(CONFIG_DIR):
+    for cfg_path in sorted(CONFIG_DIR.glob("*.yml")):
-        if not fname.endswith(".yml"):
+        repo = cfg_path.stem
-            continue
+        with cfg_path.open() as fh:
-        repo = fname[:-4]
+            cfg = yaml.safe_load(fh) or {}
-        with open(os.path.join(CONFIG_DIR, fname)) as f:
+        rules = cfg.get("rules", {})
-            cfg = yaml.safe_load(f)
+        rules.setdefault("branch", cfg.get("branch", "main"))
-        if apply_protection(repo, cfg.get("rules", {})):
+        if apply_protection(repo, rules):
             ok += 1
 
     print(f"\nSynced {ok} repo(s)")

tests/test_agent_memory.py

@@ -20,6 +20,7 @@ from agent.memory import (
     SessionTranscript,
     create_agent_memory,
 )
+from nexus.mempalace.conversation_artifacts import ConversationArtifact
 from agent.memory_hooks import MemoryHooks
 
 
@@ -184,6 +185,24 @@ class TestAgentMemory:
         doc_id = mem.write_diary()
         assert doc_id is None  # MemPalace unavailable
 
+    def test_remember_alexander_request_response_uses_sovereign_room(self):
+        mem = AgentMemory(agent_name="allegro")
+        mem._available = True
+        with patch("nexus.mempalace.searcher.add_memory", return_value="doc-123") as add_memory:
+            doc_id = mem.remember_alexander_request_response(
+                request_text="Catalog my requests.",
+                response_text="I will preserve them as artifacts.",
+                requester="Alexander Whitestone",
+                source="telegram:timmy-time",
+            )
+
+        assert doc_id == "doc-123"
+        kwargs = add_memory.call_args.kwargs
+        assert kwargs["room"] == "sovereign"
+        assert kwargs["wing"] == mem.wing
+        assert kwargs["extra_metadata"]["artifact_type"] == "alexander_request_response"
+        assert kwargs["extra_metadata"]["speaker_tags"] == ["speaker:alexander", "speaker:allegro"]
+
 
 # ---------------------------------------------------------------------------
 # MemoryHooks tests

tests/test_chronicle.py

@@ -0,0 +1,211 @@
+"""
+Tests for nexus.chronicle — emergent narrative from agent interactions.
+"""
+
+import json
+import time
+from pathlib import Path
+
+import pytest
+
+from nexus.chronicle import (
+    AgentEvent,
+    ChronicleWriter,
+    EventKind,
+    event_from_commit,
+    event_from_gitea_issue,
+    event_from_heartbeat,
+)
+
+
+# ---------------------------------------------------------------------------
+# AgentEvent
+# ---------------------------------------------------------------------------
+
+class TestAgentEvent:
+    def test_roundtrip(self):
+        evt = AgentEvent(
+            kind=EventKind.DISPATCH,
+            agent="claude",
+            detail="took issue #42",
+        )
+        assert AgentEvent.from_dict(evt.to_dict()).kind == EventKind.DISPATCH
+        assert AgentEvent.from_dict(evt.to_dict()).agent == "claude"
+        assert AgentEvent.from_dict(evt.to_dict()).detail == "took issue #42"
+
+    def test_default_timestamp_is_recent(self):
+        before = time.time()
+        evt = AgentEvent(kind=EventKind.IDLE, agent="mimo")
+        after = time.time()
+        assert before <= evt.timestamp <= after
+
+    def test_all_event_kinds_are_valid_strings(self):
+        for kind in EventKind:
+            evt = AgentEvent(kind=kind, agent="test-agent")
+            d = evt.to_dict()
+            assert d["kind"] == kind.value
+            restored = AgentEvent.from_dict(d)
+            assert restored.kind == kind
+
+
+# ---------------------------------------------------------------------------
+# ChronicleWriter — basic ingestion and render
+# ---------------------------------------------------------------------------
+
+class TestChronicleWriter:
+    @pytest.fixture
+    def writer(self, tmp_path):
+        return ChronicleWriter(log_path=tmp_path / "chronicle.jsonl")
+
+    def test_empty_render(self, writer):
+        text = writer.render()
+        assert "empty" in text.lower()
+
+    def test_single_event_render(self, writer):
+        writer.ingest(AgentEvent(kind=EventKind.DISPATCH, agent="claude", detail="issue #1"))
+        text = writer.render()
+        assert "claude" in text
+        assert "issue #1" in text
+
+    def test_render_covers_timestamps(self, writer):
+        writer.ingest(AgentEvent(kind=EventKind.DISPATCH, agent="a", detail="start"))
+        writer.ingest(AgentEvent(kind=EventKind.COMMIT, agent="a", detail="done"))
+        text = writer.render()
+        assert "chronicle covers" in text.lower()
+
+    def test_events_persisted_to_disk(self, writer, tmp_path):
+        writer.ingest(AgentEvent(kind=EventKind.COMMIT, agent="claude", detail="feat: x"))
+        lines = (tmp_path / "chronicle.jsonl").read_text().strip().splitlines()
+        assert len(lines) == 1
+        data = json.loads(lines[0])
+        assert data["kind"] == "commit"
+        assert data["agent"] == "claude"
+
+    def test_load_existing_on_init(self, tmp_path):
+        log = tmp_path / "chronicle.jsonl"
+        evt = AgentEvent(kind=EventKind.PUSH, agent="mimo", detail="pushed branch")
+        log.write_text(json.dumps(evt.to_dict()) + "\n")
+
+        writer2 = ChronicleWriter(log_path=log)
+        assert len(writer2._events) == 1
+        assert writer2._events[0].kind == EventKind.PUSH
+
+    def test_malformed_lines_are_skipped(self, tmp_path):
+        log = tmp_path / "chronicle.jsonl"
+        log.write_text("not-json\n{}\n")
+        # Should not raise
+        writer2 = ChronicleWriter(log_path=log)
+        assert writer2._events == []
+
+    def test_template_rotation(self, writer):
+        """Consecutive events of the same kind use different templates."""
+        sentences = set()
+        for _ in range(3):
+            writer.ingest(AgentEvent(kind=EventKind.HEARTBEAT, agent="claude"))
+        text = writer.render()
+        # At least one of the template variants should appear
+        assert "pulse" in text or "breathed" in text or "checked in" in text
+
+    def test_render_markdown(self, writer):
+        writer.ingest(AgentEvent(kind=EventKind.PR_OPEN, agent="claude", detail="PR #99"))
+        md = writer.render_markdown()
+        assert md.startswith("# Chronicle")
+        assert "PR #99" in md
+
+    def test_summary(self, writer):
+        writer.ingest(AgentEvent(kind=EventKind.DISPATCH, agent="claude", detail="x"))
+        writer.ingest(AgentEvent(kind=EventKind.COMMIT, agent="claude", detail="y"))
+        s = writer.summary()
+        assert s["total_events"] == 2
+        assert "claude" in s["agents"]
+        assert s["kind_counts"]["dispatch"] == 1
+        assert s["kind_counts"]["commit"] == 1
+
+    def test_max_events_limit(self, writer):
+        for i in range(10):
+            writer.ingest(AgentEvent(kind=EventKind.IDLE, agent="a", detail=str(i)))
+        text = writer.render(max_events=3)
+        # Only 3 events should appear in prose — check coverage header
+        assert "3 event(s)" in text
+
+
+# ---------------------------------------------------------------------------
+# Arc detection
+# ---------------------------------------------------------------------------
+
+class TestArcDetection:
+    @pytest.fixture
+    def writer(self, tmp_path):
+        return ChronicleWriter(log_path=tmp_path / "chronicle.jsonl")
+
+    def _ingest(self, writer, *kinds, agent="claude"):
+        for k in kinds:
+            writer.ingest(AgentEvent(kind=k, agent=agent, detail="x"))
+
+    def test_struggle_and_recovery_arc(self, writer):
+        self._ingest(writer, EventKind.DISPATCH, EventKind.ERROR, EventKind.RECOVERY)
+        text = writer.render()
+        assert "struggle" in text.lower() or "trouble" in text.lower()
+
+    def test_no_arc_when_no_pattern(self, writer):
+        self._ingest(writer, EventKind.IDLE)
+        text = writer.render()
+        # Should not include arc language (only 1 event, no pattern)
+        assert "converged" not in text
+        assert "struggle" not in text
+
+    def test_solo_sprint_arc(self, writer):
+        self._ingest(
+            writer,
+            EventKind.DISPATCH,
+            EventKind.COMMIT,
+            EventKind.PR_OPEN,
+            EventKind.PR_MERGE,
+        )
+        text = writer.render()
+        assert "solo" in text.lower() or "alone" in text.lower()
+
+    def test_fleet_convergence_arc(self, writer, tmp_path):
+        writer2 = ChronicleWriter(log_path=tmp_path / "chronicle.jsonl")
+        writer2.ingest(AgentEvent(kind=EventKind.DISPATCH, agent="claude", detail="x"))
+        writer2.ingest(AgentEvent(kind=EventKind.COLLABORATION, agent="mimo", detail="x"))
+        writer2.ingest(AgentEvent(kind=EventKind.COMMIT, agent="claude", detail="x"))
+        text = writer2.render()
+        assert "converged" in text.lower() or "fleet" in text.lower()
+
+    def test_silent_grind_arc(self, writer):
+        self._ingest(writer, EventKind.COMMIT, EventKind.COMMIT, EventKind.COMMIT)
+        text = writer.render()
+        assert "steady" in text.lower() or "quiet" in text.lower() or "grind" in text.lower()
+
+    def test_abandon_then_retry_arc(self, writer):
+        self._ingest(writer, EventKind.DISPATCH, EventKind.ABANDON, EventKind.DISPATCH)
+        text = writer.render()
+        assert "let go" in text.lower() or "abandon" in text.lower() or "called again" in text.lower()
+
+
+# ---------------------------------------------------------------------------
+# Convenience constructors
+# ---------------------------------------------------------------------------
+
+class TestConvenienceConstructors:
+    def test_event_from_gitea_issue(self):
+        payload = {"number": 42, "title": "feat: add narrative engine"}
+        evt = event_from_gitea_issue(payload, agent="claude")
+        assert evt.kind == EventKind.DISPATCH
+        assert "42" in evt.detail
+        assert evt.agent == "claude"
+
+    def test_event_from_heartbeat(self):
+        hb = {"model": "claude-sonnet", "status": "thinking", "cycle": 7}
+        evt = event_from_heartbeat(hb)
+        assert evt.kind == EventKind.HEARTBEAT
+        assert evt.agent == "claude-sonnet"
+        assert "7" in evt.detail
+
+    def test_event_from_commit(self):
+        commit = {"message": "feat: chronicle\n\nFixes #1607", "sha": "abc1234567"}
+        evt = event_from_commit(commit, agent="claude")
+        assert evt.kind == EventKind.COMMIT
+        assert evt.detail == "feat: chronicle"  # subject line only
+        assert evt.metadata["sha"] == "abc12345"

tests/test_conversation_artifacts.py

@@ -0,0 +1,58 @@
+from pathlib import Path
+
+import yaml
+
+from nexus.mempalace.config import CORE_ROOMS
+from nexus.mempalace.conversation_artifacts import (
+    ConversationArtifact,
+    build_request_response_artifact,
+    extract_alexander_request_pairs,
+    normalize_speaker,
+)
+
+
+def test_sovereign_room_is_core_room() -> None:
+    assert "sovereign" in CORE_ROOMS
+    rooms_yaml = yaml.safe_load(Path("mempalace/rooms.yaml").read_text())
+    assert any(room["key"] == "sovereign" for room in rooms_yaml["core_rooms"])
+
+
+def test_normalize_speaker_maps_alexander_variants() -> None:
+    assert normalize_speaker("Alexander Whitestone") == "alexander"
+    assert normalize_speaker("Rockachopa") == "alexander"
+    assert normalize_speaker("  ALEXANDER  ") == "alexander"
+    assert normalize_speaker("Bezalel") == "bezalel"
+
+
+def test_build_request_response_artifact_creates_sovereign_metadata() -> None:
+    artifact = build_request_response_artifact(
+        requester="Alexander Whitestone",
+        responder="Allegro",
+        request_text="Please organize my conversation artifacts.",
+        response_text="I will catalog them under a sovereign room.",
+        source="telegram:timmy-time",
+        timestamp="2026-04-16T01:30:00Z",
+    )
+
+    assert isinstance(artifact, ConversationArtifact)
+    assert artifact.room == "sovereign"
+    assert artifact.metadata["speaker_tags"] == ["speaker:alexander", "speaker:allegro"]
+    assert artifact.metadata["artifact_type"] == "alexander_request_response"
+    assert artifact.metadata["responder"] == "allegro"
+    assert "## Alexander Request" in artifact.text
+    assert "## Wizard Response" in artifact.text
+
+
+def test_extract_alexander_request_pairs_finds_following_wizard_response() -> None:
+    turns = [
+        {"speaker": "Alexander Whitestone", "text": "Catalog my requests as artifacts.", "timestamp": "2026-04-16T01:00:00Z"},
+        {"speaker": "Allegro", "text": "I'll build a sovereign room contract.", "timestamp": "2026-04-16T01:01:00Z"},
+        {"speaker": "Alexander", "text": "Make sure my words are easy to recall.", "timestamp": "2026-04-16T01:02:00Z"},
+        {"speaker": "Allegro", "text": "I will tag them with speaker metadata.", "timestamp": "2026-04-16T01:03:00Z"},
+    ]
+
+    artifacts = extract_alexander_request_pairs(turns, responder="Allegro", source="telegram")
+
+    assert len(artifacts) == 2
+    assert artifacts[0].metadata["request_timestamp"] == "2026-04-16T01:00:00Z"
+    assert artifacts[1].metadata["response_timestamp"] == "2026-04-16T01:03:00Z"

tests/test_mission_bus.py

@@ -1,107 +0,0 @@
-from importlib import util
-from pathlib import Path
-import sys
-
-import pytest
-
-
-ROOT = Path(__file__).resolve().parent.parent
-MODULE_PATH = ROOT / "nexus" / "mission_bus.py"
-CONFIG_PATH = ROOT / "config" / "mission_bus_profiles.json"
-
-
-def load_module():
-    spec = util.spec_from_file_location("mission_bus", MODULE_PATH)
-    module = util.module_from_spec(spec)
-    assert spec.loader is not None
-    sys.modules[spec.name] = module
-    spec.loader.exec_module(module)
-    return module
-
-
-def build_bus(module):
-    profiles = module.load_profiles(CONFIG_PATH)
-    bus = module.MissionBus("mission-883", title="multi-agent teaming", config=profiles)
-    bus.register_participant("timmy", module.MissionRole.LEAD)
-    bus.register_participant("ezra", module.MissionRole.WRITE)
-    bus.register_participant("bezalel", module.MissionRole.READ)
-    bus.register_participant("allegro", module.MissionRole.AUDIT)
-    return bus
-
-
-def test_role_permissions_gate_publish_checkpoint_and_handoff():
-    module = load_module()
-    bus = build_bus(module)
-
-    assert bus.allowed("timmy", "publish") is True
-    assert bus.allowed("ezra", "handoff") is True
-    assert bus.allowed("allegro", "audit") is True
-    assert bus.allowed("bezalel", "publish") is False
-
-    with pytest.raises(PermissionError):
-        bus.publish("bezalel", "mission.notes", {"text": "should fail"})
-
-    with pytest.raises(PermissionError):
-        bus.create_checkpoint("allegro", summary="audit cannot checkpoint", state={})
-
-
-def test_mission_bus_unified_stream_records_messages_checkpoints_and_handoffs():
-    module = load_module()
-    bus = build_bus(module)
-
-    msg = bus.publish("timmy", "mission.start", {"goal": "build the slice"})
-    checkpoint = bus.create_checkpoint(
-        "ezra",
-        summary="checkpoint before lead review",
-        state={"branch": "fix/883", "files": ["nexus/mission_bus.py"]},
-        artifacts=["docs/mission-bus.md"],
-    )
-    handoff = bus.handoff("ezra", "timmy", checkpoint.checkpoint_id, note="ready for lead review")
-
-    assert [event.event_type for event in bus.events] == ["message", "checkpoint", "handoff"]
-    assert [event.sequence for event in bus.events] == [1, 2, 3]
-    assert msg.topic == "mission.start"
-    assert handoff.recipient == "timmy"
-
-
-def test_handoff_resume_packet_contains_checkpoint_state_and_participants():
-    module = load_module()
-    bus = build_bus(module)
-    checkpoint = bus.create_checkpoint(
-        "ezra",
-        summary="handoff package",
-        state={"branch": "fix/883", "tests": ["tests/test_mission_bus.py"]},
-        artifacts=["config/mission_bus_profiles.json"],
-    )
-    handoff = bus.handoff("ezra", "timmy", checkpoint.checkpoint_id, note="pick up from here")
-
-    packet = bus.build_resume_packet(handoff.handoff_id)
-    assert packet["recipient"] == "timmy"
-    assert packet["checkpoint"]["state"]["branch"] == "fix/883"
-    assert packet["checkpoint"]["artifacts"] == ["config/mission_bus_profiles.json"]
-    assert packet["participants"]["ezra"]["role"] == "write"
-    assert packet["handoff_note"] == "pick up from here"
-
-
-def test_profiles_define_level2_mount_namespace_and_level3_rootless_podman():
-    module = load_module()
-    profiles = module.load_profiles(CONFIG_PATH)
-
-    levels = {entry["level"]: entry["mechanism"] for entry in profiles["isolation_profiles"]}
-    assert levels[2] == "mount_namespace"
-    assert levels[3] == "rootless_podman"
-    assert profiles["roles"]["audit"] == ["read", "audit"]
-
-
-def test_mission_bus_roundtrip_preserves_events_and_isolation_profile():
-    module = load_module()
-    bus = build_bus(module)
-    bus.publish("timmy", "mission.start", {"goal": "roundtrip"})
-    checkpoint = bus.create_checkpoint("ezra", summary="save state", state={"count": 1})
-    bus.handoff("ezra", "timmy", checkpoint.checkpoint_id, note="resume")
-
-    restored = module.MissionBus.from_dict(bus.to_dict())
-    assert restored.mission_id == "mission-883"
-    assert restored.events[-1].event_type == "handoff"
-    assert restored.events[-1].note == "resume"
-    assert restored.isolation_profiles[1].mechanism == "mount_namespace"

tests/test_sync_branch_protection.py

@@ -0,0 +1,45 @@
+from __future__ import annotations
+
+import importlib.util
+import sys
+from pathlib import Path
+
+import yaml
+
+PROJECT_ROOT = Path(__file__).parent.parent
+
+_spec = importlib.util.spec_from_file_location(
+    "sync_branch_protection_test",
+    PROJECT_ROOT / "scripts" / "sync_branch_protection.py",
+)
+_mod = importlib.util.module_from_spec(_spec)
+sys.modules["sync_branch_protection_test"] = _mod
+_spec.loader.exec_module(_mod)
+
+build_branch_protection_payload = _mod.build_branch_protection_payload
+
+
+def test_build_branch_protection_payload_enables_rebase_before_merge():
+    payload = build_branch_protection_payload(
+        "main",
+        {
+            "required_approvals": 1,
+            "dismiss_stale_approvals": True,
+            "require_ci_to_merge": False,
+            "block_deletions": True,
+            "block_force_push": True,
+            "block_on_outdated_branch": True,
+        },
+    )
+
+    assert payload["branch_name"] == "main"
+    assert payload["rule_name"] == "main"
+    assert payload["block_on_outdated_branch"] is True
+    assert payload["required_approvals"] == 1
+    assert payload["enable_status_check"] is False
+
+
+def test_the_nexus_branch_protection_config_requires_up_to_date_branch():
+    config = yaml.safe_load((PROJECT_ROOT / ".gitea" / "branch-protection" / "the-nexus.yml").read_text())
+    rules = config["rules"]
+    assert rules["block_on_outdated_branch"] is True