@a-company/paradigm 5.28.0 → 5.31.0

package/dist/university-content/courses/para-501.json

@@ -956,6 +956,61 @@
         }
       ]
     },
+    {
+      "id": "conductor-workspace",
+      "title": "Conductor: Visual Mission Control",
+      "content": "## What Is Conductor?\n\nConductor is a native macOS application that serves as the visual mission control for Paradigm. While the CLI and MCP tools handle the automation, Conductor gives you a real-time view of what your agent team is doing — and lets you interact with them visually.\n\nThink of it as the difference between managing a team over email versus walking into a mission control room. Both work, but the room gives you instant awareness.\n\n### Core Capabilities\n\n**Workspace Mode** — A full-screen tiling window manager for Claude Code sessions. Launch multiple terminals side by side, split horizontally or vertically, drag dividers to resize. Six layout presets (single, split-h, split-v, quad, triple, grid) let you quickly arrange your workspace.\n\n**Symphony Integration** — Conductor connects to Symphony, the inter-agent messaging system. When agents communicate during orchestration (handing off context, requesting approval, debating approaches), those messages appear in Conductor's thread view in real time. You can read the full conversation without switching to the CLI.\n\n**Task Protocol** — A structured protocol for human-agent coordination with 7 intents:\n- `task` — assign work to an agent\n- `task-ack` — agent acknowledges receipt\n- `progress` — agent reports progress\n- `approval-request` — agent asks for human approval\n- `approval-response` — human approves or rejects\n- `task-complete` — agent reports success\n- `task-failed` — agent reports failure\n\nThis protocol makes agent work visible and controllable. You see when agents are working, what they are asking, and whether they succeeded.\n\n**Agent Health Dashboard** — Per-agent metrics: success rates, average time-per-task, acceptance rates for contributions. Sparklines show trends over time. When an agent's performance drops, you see it immediately.\n\n**Live Sentinel** — Real-time event viewer with symbol filtering. When Sentinel detects an incident or pattern, it appears in Conductor's event feed with full detail and suggested resolution.\n\n### Architecture\n\nConductor is built with Swift and SwiftUI — a native macOS application, not an Electron wrapper. Key design decisions:\n\n- **Single-owner pattern** — AppDelegate owns the orchestrator, workspace, project store, and agent process manager. No shared mutable state.\n- **Local-only ML** — Gaze tracking, gesture recognition, and voice commands all run locally via CoreML. Zero cloud, zero cost, zero latency.\n- **SwiftTerm embedding** — Terminal sessions use SwiftTerm, a native Swift terminal emulator. Each session is a real PTY with full ANSI support.\n- **7 platform protocols** — Abstraction layer for future portability (the same protocol set would power a Windows or Linux version).\n\n### Getting Started\n\nBuild and install Conductor:\n\n```bash\ncd packages/conductor\n./build-conductor.sh --install\n```\n\nThis produces `Conductor.app` in `/Applications`. Launch it, and it connects to your Paradigm project automatically.\n\n### When to Use Conductor\n\n- **During orchestration** — watch agents work in real time, approve contributions, read debates\n- **Multi-session development** — tile 2-4 Claude Code sessions side by side, each working on different parts of the codebase\n- **Monitoring** — keep Conductor visible on a secondary display to catch Sentinel events and agent health changes\n- **Team collaboration** — when multiple developers use Symphony, Conductor shows cross-session threads and file approval requests\n\nConductor is optional — everything it shows is also available via CLI and MCP tools. But for teams that want visual awareness of their agent team, it is the command center.",
+      "keyConcepts": [
+        "Conductor is a native macOS SwiftUI application — not Electron",
+        "Workspace mode provides tiling terminal management with 6 layout presets",
+        "Symphony integration shows inter-agent messages in real time",
+        "Task protocol has 7 intents for structured human-agent coordination",
+        "Agent health dashboard tracks per-agent success rates and trends",
+        "All ML inference (gaze, gesture, voice) runs locally via CoreML",
+        "Optional but powerful — everything is also available via CLI"
+      ],
+      "quiz": [
+        {
+          "id": "q1",
+          "question": "During orchestration, the security agent sends an approval-request via Symphony asking to modify portal.yaml. Where would you see and respond to this in Conductor?",
+          "choices": {
+            "A": "In the terminal session where the agent is running",
+            "B": "In the Symphony thread view — approval-request is a task protocol intent that appears as a message you can approve or reject",
+            "C": "In the agent health dashboard under the security agent's metrics",
+            "D": "In the Sentinel event feed as a security incident",
+            "E": "You cannot — approval requests only work via CLI"
+          },
+          "correct": "B",
+          "explanation": "Symphony messages, including task protocol intents like approval-request, appear in Conductor's thread view in real time. The task protocol is designed for human-agent coordination — you see the request, read the context, and respond with approval-response directly in the thread view. This is one of Conductor's key advantages over CLI-only workflows."
+        },
+        {
+          "id": "q2",
+          "question": "You want to work on the frontend and backend of a feature simultaneously with two Claude Code sessions. How would you set this up in Conductor?",
+          "choices": {
+            "A": "Launch two separate Conductor apps",
+            "B": "Use workspace mode with a split-h or split-v layout preset, launching one terminal session per pane",
+            "C": "Conductor only supports one session at a time",
+            "D": "Use the agent health dashboard to assign work to two agents",
+            "E": "Use Symphony to relay messages between two CLI sessions instead"
+          },
+          "correct": "B",
+          "explanation": "Conductor's workspace mode is a tiling window manager for Claude Code sessions. Choose a split layout preset (horizontal or vertical), and each pane gets its own terminal session. Both sessions connect to Symphony, so they can coordinate via inter-agent messaging while you watch both in a single window."
+        },
+        {
+          "id": "q3",
+          "question": "Conductor's ML features (gaze tracking, gesture recognition, voice commands) all run locally via CoreML. Why is this significant?",
+          "choices": {
+            "A": "CoreML is faster than cloud APIs for all tasks",
+            "B": "It means zero cloud cost, zero data leaving your machine, and zero network latency — critical for a developer tool that sees your code and screen",
+            "C": "Apple requires all macOS apps to use CoreML",
+            "D": "Cloud ML services do not support gaze tracking",
+            "E": "It is not significant — it is just an implementation detail"
+          },
+          "correct": "B",
+          "explanation": "For a developer tool that has access to your codebase, screen content, and camera feed, privacy is paramount. Local-only ML means your data never leaves your machine — no cloud processing, no storage, no costs. The zero-latency benefit is a bonus, but the privacy guarantee is the real reason this design choice matters."
+        }
+      ]
+    },
     {
       "id": "symphony-networking",
       "title": "Symphony Networking: Cross-Machine Relay",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a-company/paradigm",
-  "version": "5.28.0",
+  "version": "5.31.0",
   "description": "Unified CLI for Paradigm developer tools",
   "type": "module",
   "main": "./dist/index.js",

package/dist/chunk-4DVT5IEY.js

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-import*as a from'fs';import*as c from'path';import {Glob}from'glob';function s(t){let e=r=>{if(r.includes("*"))try{return new Glob(r,{cwd:t,nodir:!0}).walkSync().length>0}catch{return  false}return a.existsSync(c.join(t,r))};return e("project.godot")||e("Assets/ProjectSettings")?"game":e("Package.swift")&&!e("package.json")?e("Sources/*/App")||e("**/AppDelegate.swift")?"macos-app":"ios-app":e("pubspec.yaml")?"flutter-app":e("supabase")&&(e("next.config.*")||e("vite.config.*"))?"saas-web-app":e("next.config.*")||e("vite.config.*")||e("nuxt.config.*")?"web-app":e("Dockerfile")||e("prisma")||e("drizzle.config.*")?"backend-api":e("Cargo.toml")?"rust-project":e("pyproject.toml")||e("setup.py")||e("requirements.txt")?"python-project":"generic"}var n={"saas-web-app":["advocate","architect","builder","reviewer","tester","security","documentor","designer","copywriter","performance","devops","dba","e2e","dx","seo","pm","product","sales","legal","a11y","qa","debugger","release","narrator"],"web-app":["advocate","architect","builder","reviewer","tester","security","documentor","designer","copywriter","performance","devops","e2e","seo","a11y","qa","debugger"],"backend-api":["advocate","architect","builder","reviewer","tester","security","documentor","devops","dba","performance","dx","qa","debugger","release"],"ios-app":["advocate","architect","builder","reviewer","tester","security","documentor","designer","mobile","performance","a11y","qa","debugger"],"macos-app":["advocate","architect","builder","reviewer","tester","security","documentor","designer","performance","qa","debugger"],"flutter-app":["advocate","architect","builder","reviewer","tester","security","documentor","designer","mobile","performance","a11y","debugger"],game:["advocate","architect","builder","reviewer","tester","documentor","gamedev","3d","audio","designer","performance","debugger"],"rust-project":["advocate","architect","builder","reviewer","tester","security","documentor","performance","debugger","qa"],"python-project":["advocate","architect","builder","reviewer","tester","security","documentor","performance","debugger","qa"],generic:["advocate","architect","builder","reviewer","tester","security","documentor","debugger","qa"]};export{s as a,n as b};