maestro-cue-spinout: 48 tasks across 2026-02-14-Maestro-Cue/MAESTRO-CUE-01, 2026-02-14-Maestro-Cue/MAESTRO-CUE-02 +12 more

CLAUDE-IPC.md

@@ -43,6 +43,7 @@ The `window.maestro` API exposes the following namespaces:
 - `history` - Per-agent execution history (see History API below)
 - `cli` - CLI activity detection for playbook runs
 - `tempfile` - Temporary file management for batch processing
+- `cue` - Maestro Cue event-driven automation (see Cue API below)
 
 ## Analytics & Visualization
 
@@ -74,6 +75,40 @@ window.maestro.history = {
 
 **AI Context Integration**: Use `getFilePath(sessionId)` to get the path to an agent's history file. This file can be passed directly to AI agents as context, giving them visibility into past completed tasks, decisions, and work patterns.
 
+## Cue API
+
+Maestro Cue event-driven automation engine. Gated behind the `maestroCue` Encore Feature flag.
+
+```typescript
+window.maestro.cue = {
+  // Query engine state
+  getStatus: () => Promise<CueSessionStatus[]>,
+  getActiveRuns: () => Promise<CueRunResult[]>,
+  getActivityLog: (limit?) => Promise<CueRunResult[]>,
+
+  // Engine controls
+  enable: () => Promise<void>,
+  disable: () => Promise<void>,
+
+  // Run management
+  stopRun: (runId) => Promise<boolean>,
+  stopAll: () => Promise<void>,
+
+  // Session config management
+  refreshSession: (sessionId, projectRoot) => Promise<void>,
+
+  // YAML config file operations
+  readYaml: (projectRoot) => Promise<string | null>,
+  writeYaml: (projectRoot, content) => Promise<void>,
+  validateYaml: (content) => Promise<{ valid: boolean; errors: string[] }>,
+
+  // Real-time updates
+  onActivityUpdate: (callback) => () => void,  // Returns unsubscribe function
+};
+```
+
+**Events:** `cue:activityUpdate` is pushed from main process on subscription triggers, run completions, config reloads, and config removals.
+
 ## Power Management
 
 - `power` - Sleep prevention: setEnabled, isEnabled, getStatus, addReason, removeReason

CLAUDE-PATTERNS.md

@@ -348,16 +348,25 @@ When adding a new Encore Feature, gate **all** access points:
 6. **Hamburger menu** — Make the setter optional, conditionally render the menu item in `SessionList.tsx`
 7. **Command palette** — Pass `undefined` for the handler in `QuickActionsModal.tsx` (already conditionally renders based on handler existence)
 
-### Reference Implementation: Director's Notes
+### Reference Implementations
 
-Director's Notes is the first Encore Feature and serves as the canonical example:
+**Director's Notes** — First Encore Feature, canonical example:
 
 - **Flag:** `encoreFeatures.directorNotes` in `EncoreFeatureFlags`
 - **App.tsx gating:** Modal render wrapped in `{encoreFeatures.directorNotes && directorNotesOpen && (…)}`, callback passed as `encoreFeatures.directorNotes ? () => setDirectorNotesOpen(true) : undefined`
 - **Keyboard shortcut:** `ctx.encoreFeatures?.directorNotes` guard in `useMainKeyboardHandler.ts`
 - **Hamburger menu:** `setDirectorNotesOpen` made optional in `SessionList.tsx`, button conditionally rendered with `{setDirectorNotesOpen && (…)}`
 - **Command palette:** `onOpenDirectorNotes` already conditionally renders in `QuickActionsModal.tsx` — passing `undefined` from App.tsx is sufficient
 
+**Maestro Cue** — Event-driven automation, second Encore Feature:
+
+- **Flag:** `encoreFeatures.maestroCue` in `EncoreFeatureFlags`
+- **App.tsx gating:** Cue modal, hooks (`useCue`, `useCueAutoDiscovery`), and engine lifecycle gated on `encoreFeatures.maestroCue`
+- **Keyboard shortcut:** `ctx.encoreFeatures?.maestroCue` guard in `useMainKeyboardHandler.ts`
+- **Hamburger menu:** `setMaestroCueOpen` made optional in `SessionList.tsx`
+- **Command palette:** `onOpenMaestroCue` conditionally renders in `QuickActionsModal.tsx`
+- **Session list:** Cue status indicator (Zap icon) gated on `maestroCueEnabled`
+
 When adding a new Encore Feature, mirror this pattern across all access points.
 
 See [CONTRIBUTING.md → Encore Features](CONTRIBUTING.md#encore-features-feature-gating) for the full contributor guide.

CLAUDE.md

@@ -72,6 +72,11 @@ Use "agent" in user-facing language. Reserve "session" for provider-level conver
   - **Command Terminal** - Main window in terminal/shell mode
   - **System Log Viewer** - Special view for system logs (`LogViewer.tsx`)
 
+### Automation
+
+- **Cue** — Event-driven automation system (Maestro Cue), gated as an Encore Feature. Watches for file changes, time intervals, and agent completions to trigger automated prompts. Configured via `maestro-cue.yaml` per project.
+- **Cue Modal** — Dashboard for managing Cue subscriptions and viewing activity (`CueModal.tsx`)
+
 ### Agent States (color-coded)
 
 - **Green** - Ready/idle
@@ -131,9 +136,10 @@ src/
 │   ├── preload.ts          # Secure IPC bridge
 │   ├── process-manager.ts  # Process spawning (PTY + child_process)
 │   ├── agent-*.ts          # Agent detection, capabilities, session storage
+│   ├── cue/               # Maestro Cue event-driven automation engine
 │   ├── parsers/            # Per-agent output parsers + error patterns
 │   ├── storage/            # Per-agent session storage implementations
-│   ├── ipc/handlers/       # IPC handler modules (stats, git, playbooks, etc.)
+│   ├── ipc/handlers/       # IPC handler modules (stats, git, playbooks, cue, etc.)
 │   └── utils/              # Utilities (execFile, ssh-spawn-wrapper, etc.)
 │
 ├── renderer/               # React frontend (desktop)
@@ -202,6 +208,10 @@ src/
 | Add Director's Notes feature | `src/renderer/components/DirectorNotes/`, `src/main/ipc/handlers/director-notes.ts`                                                   |
 | Add Encore Feature           | `src/renderer/types/index.ts` (flag), `useSettings.ts` (state), `SettingsModal.tsx` (toggle UI), gate in `App.tsx` + keyboard handler |
 | Modify history components    | `src/renderer/components/History/`                                                                                                    |
+| Add Cue event type           | `src/main/cue/cue-types.ts`, `src/main/cue/cue-engine.ts`                                                                             |
+| Add Cue template variable    | `src/shared/templateVariables.ts`, `src/main/cue/cue-executor.ts`                                                                     |
+| Modify Cue modal             | `src/renderer/components/CueModal.tsx`                                                                                                |
+| Configure Cue engine         | `src/main/cue/cue-engine.ts`, `src/main/ipc/handlers/cue.ts`                                                                          |
 
 ---