slavedriver 0.1.0

package/README.md

@@ -0,0 +1,165 @@
+# slavedriver
+
+**Multi-agent orchestration that actually ships code.**
+
+One command. Multiple AI agents. Parallel execution. Real results.
+
+```bash
+npx slavedriver "build a REST API with auth, users, and tests"
+```
+
+slavedriver spawns a team of AI agents that discover your codebase, plan the work, execute tasks in parallel waves, and verify the results — all with a lazygit-style TUI you can watch and control.
+
+## The Problem
+
+Multi-agent orchestration is fragmented. Every framework picks one pattern and builds a universe around it. GSD has great wave execution but no TUI. OpenClaw has the best autonomous heartbeat but requires a full server. CrewAI has nice agent roles but locks you into their ecosystem. Ralph Wiggum's iterative loop is genius but it's just a bash script.
+
+**slavedriver cherry-picks the best patterns from all of them into a single `npx` command.**
+
+## Key Features
+
+- **Wave Execution** — Tasks organized in dependency-aware waves that run in parallel (from GSD)
+- **Full TUI** — lazygit/k9s-style terminal UI with task board, agent output, and live controls
+- **Ralph Loop** — Iterative self-improvement mode: run, check, fix, repeat (from Ralph Wiggum)
+- **Heartbeat Daemon** — Autonomous scheduled agent that checks on your project (from OpenClaw)
+- **Fresh Context Per Task** — Every agent spawns clean. No context rot. Ever (from GSD)
+- **Git Worktree Isolation** — Each agent works in its own branch/directory. No conflicts (from Claude Code Teams)
+- **File-Based State** — No databases. `.slavedriver/` is the state. Human-readable. Git-friendly
+- **Zero Production Dependencies** — Built-in Node.js APIs only
+- **Model-Agnostic** — Claude Code CLI, Anthropic API, OpenAI, Ollama — bring your own backend
+- **Safety First** — Budget limits, iteration caps, path exclusions, human approval gates
+
+## Quick Start
+
+```bash
+# Run with a goal (discover -> plan -> execute -> verify)
+npx slavedriver "add user authentication with JWT"
+
+# Launch the interactive TUI
+npx slavedriver
+
+# Just generate a plan
+npx slavedriver plan "refactor the database layer"
+
+# Execute an existing plan
+npx slavedriver run
+
+# Run in Ralph Wiggum loop mode
+npx slavedriver run --ralph
+
+# Start the autonomous heartbeat daemon
+npx slavedriver heartbeat --daemon
+```
+
+## TUI
+
+```
+┌══════════════════════════════════════════════════════════════════┐
+│  SLAVEDRIVER v0.1.0  │  Project: my-api  │  Phase: EXECUTING    │
+│  Wave 2/4  │  Tasks: 3/12 done  │  Agents: 3 active  │  $0.42  │
+├═══════════════════════╤══════════════════════════════════════════┤
+│                       │                                          │
+│  TASK BOARD           │  AGENT OUTPUT                            │
+│                       │                                          │
+│  Wave 1 [████] DONE   │  > planner (opus)                        │
+│    [x] T1: Setup DB   │  Analyzing codebase structure...         │
+│    [x] T2: Init proj  │  Found 47 files across 12 modules.      │
+│                       │  Generating task dependency graph...     │
+│  Wave 2 [██  ] 1/3    │                                          │
+│    [x] T3: Auth       │  ─────────────────────────────────────   │
+│    [>] T4: User CRUD  │  > executor-1 (sonnet)                   │
+│    [>] T5: API routes │  Writing src/routes/users.ts...          │
+│                       │  Created 4 endpoints: GET, POST,         │
+│  Wave 3 [    ] 0/2    │  PUT, DELETE. Running tsc... OK          │
+│    [ ] T6: Tests      │                                          │
+│    [ ] T7: Integrate  │  ─────────────────────────────────────   │
+│                       │  > executor-2 (sonnet)                   │
+│  Wave 4 [    ] 0/1    │  Implementing auth middleware...         │
+│    [ ] T8: Deploy     │  JWT generation complete.                │
+│                       │                                          │
+├═══════════════════════╧══════════════════════════════════════════┤
+│  [q]uit [p]ause [r]esume [a]bort [l]ogs [t]asks [Tab]focus [?] │
+│  > _                                                             │
+└══════════════════════════════════════════════════════════════════┘
+```
+
+## Architecture Overview
+
+```
+CLI / TUI
+    │
+    ├── Orchestrator (state machine: DISCOVER → PLAN → EXECUTE → VERIFY)
+    │       │
+    │       ├── Task Graph (DAG with wave-based parallel execution)
+    │       ├── Safety Engine (budgets, caps, exclusions)
+    │       ├── Heartbeat Daemon (autonomous scheduled runs)
+    │       └── Ralph Loop (iterative self-improvement mode)
+    │
+    ├── Session Manager (tmux backend + git worktree isolation)
+    │       │
+    │       └── Agent 1..N (each in isolated worktree + fresh context)
+    │
+    ├── Agent Runtime (model-agnostic abstraction)
+    │       │
+    │       └── Backends: Claude Code CLI | Anthropic API | OpenAI | Ollama
+    │
+    └── State Store (file-based, .slavedriver/ directory)
+            │
+            ├── STATE.md, PLAN.md, CONTEXT.md
+            ├── tasks.jsonl (append-only event log)
+            └── config.json
+```
+
+See [`.planning/ARCHITECTURE.md`](.planning/ARCHITECTURE.md) for the full system design.
+
+## Project Structure
+
+```
+.slavedriver/           # Per-project state (created by `slavedriver init`)
+  ├── config.json       # Project configuration + safety limits
+  ├── STATE.md          # Current project state (<100 lines, always current)
+  ├── CONTEXT.md        # Locked decisions all agents must respect
+  ├── PLAN.md           # XML-structured task plan with waves
+  ├── CONSTITUTION.md   # Project-level non-negotiable principles
+  ├── HEARTBEAT.md      # What the heartbeat daemon should check
+  ├── tasks.jsonl       # Append-only task event log
+  ├── sessions/         # Agent session data
+  ├── memory/           # Per-agent persistent memory
+  └── worktrees/        # Git worktree directories per agent
+```
+
+## Inspiration & Credits
+
+slavedriver stands on the shoulders of these projects:
+
+| Project | What We Took | License |
+|---------|-------------|---------|
+| [GSD](https://github.com/get-shit-done) | Wave execution, fresh context per task, atomic commits, `.planning/` pattern | MIT |
+| [OpenClaw](https://docs.openclaw.ai) | Heartbeat daemon, skills system, file-based state philosophy | MIT |
+| [Ralph Wiggum Loop](https://ghuntley.com/ralph/) | Iterative self-improvement loop, worker/reviewer dual-model, git-as-memory | MIT |
+| [Goose](https://github.com/block/goose) | MCP extension system, recipe format, permission modes, subagent limits | Apache 2.0 |
+| [Warp Terminal](https://www.warp.dev) | Block-based output, tiered approval UX, agent management panel, Oz orchestration | Proprietary |
+| [BMAD](https://github.com/bmad-method) | Artifact-first development, quality gates, agent roles | MIT |
+| [Spec Kit](https://github.com/spec-kit) | Spec-driven workflow, phase context templates | MIT |
+| [Claude Code](https://docs.anthropic.com) | Git worktree isolation, orchestrator-worker, hooks system, stream JSON | — |
+| [Claude Cowork](https://claude.com/blog/cowork-research-preview) | No-code plugin system, VM sandboxing, two-tier parallelism, 15+ lifecycle hooks | — |
+| [CrewAI](https://github.com/crewai) | Role-based agents, crew/flow hybrid, YAML agent definitions | Apache 2.0 |
+| [Devin](https://devin.ai) | Four-tab workspace, following toggle, auto-proceed approval, machine snapshots | Proprietary |
+| [Cursor](https://cursor.com) | Agent sessions sidebar, parallel agents, aggregated diff view | Proprietary |
+| [LangGraph Studio](https://github.com/langchain-ai/langgraph) | Time travel / state forking, graph-as-execution-trace | MIT |
+
+## Documentation
+
+- [Architecture](.planning/ARCHITECTURE.md) — Full system design, interfaces, state machines
+- [Requirements](.planning/REQUIREMENTS.md) — All v1 requirements with IDs
+- [Roadmap](.planning/ROADMAP.md) — Phased milestones and success criteria
+- [Stack](.planning/STACK.md) — Technology decisions and rationale
+- [Conventions](.planning/CONVENTIONS.md) — Coding standards and patterns
+- [Research](.planning/RESEARCH.md) — Framework analysis and pattern extraction
+- [References](.planning/references/INDEX.md) — Deep implementation references from all inspiration projects
+- [Project State](.planning/STATE.md) — Current status and open questions
+- [Constitution](CONSTITUTION.md) — Non-negotiable project principles
+
+## License
+
+MIT

package/agents/executor.md

@@ -0,0 +1,26 @@
+---
+name: executor
+role: "Code implementation specialist"
+model: sonnet
+maxTurns: 50
+tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - Glob
+  - Grep
+color: green
+icon: ">"
+---
+
+You are an executor agent for slavedriver. Your job is to implement a single task as described in your prompt.
+
+## Rules
+
+- Read existing code before modifying it
+- Follow the project's coding conventions
+- Write clean, working code — not placeholder stubs
+- Run tests if they exist
+- Create one atomic commit when done
+- Do not modify files outside your task scope

package/agents/planner.md

@@ -0,0 +1,41 @@
+---
+name: planner
+role: "Strategic task planning and decomposition"
+model: opus
+maxTurns: 30
+color: blue
+icon: "P"
+---
+
+You are a planner agent for slavedriver. Your job is to analyze a codebase and create a structured task plan.
+
+## Your Output
+
+You MUST output a valid PLAN.md with this exact format:
+
+# Plan: [Goal Description]
+
+## Must-Haves
+- [List of verification criteria]
+
+## Tasks
+
+<task id="T1" wave="1" agent="executor" priority="critical">
+  <title>Task title</title>
+  <depends-on></depends-on>
+  <description>What to do</description>
+  <must-haves>
+    - Specific success criteria
+  </must-haves>
+  <verification>How to verify</verification>
+  <mode>one-shot</mode>
+</task>
+
+## Rules
+
+- Group independent tasks into the same wave
+- Tasks that depend on others go in later waves
+- Every task must have clear, testable must-haves
+- Prefer smaller, focused tasks over large ones
+- Use "critical" priority for tasks that block everything
+- Use "ralph-loop" mode only for tasks requiring iterative correctness

package/agents/researcher.md

@@ -0,0 +1,28 @@
+---
+name: researcher
+role: "Codebase analysis and exploration"
+model: haiku
+maxTurns: 15
+color: cyan
+icon: "R"
+---
+
+You are a researcher agent for slavedriver. Your job is to analyze a codebase and produce a concise summary.
+
+## Process
+
+1. Check for project files (package.json, Cargo.toml, go.mod, etc.)
+2. List the directory structure
+3. Read key files (entry points, configs, READMEs)
+4. Identify architecture patterns, frameworks, and conventions
+
+## Output
+
+Write a concise STATE.md with:
+- Project type and language
+- Framework and key dependencies
+- Directory structure summary
+- Architecture patterns
+- Entry points
+- Test setup
+- Key conventions to follow

package/agents/verifier.md

@@ -0,0 +1,25 @@
+---
+name: verifier
+role: "Goal-backward verification specialist"
+model: opus
+maxTurns: 20
+color: yellow
+icon: "V"
+---
+
+You are a verifier agent for slavedriver. Your job is to check whether the planned must-haves have been achieved.
+
+## Process
+
+1. Read the must-haves from the plan
+2. For each must-have, check the actual codebase
+3. Run tests, type checks, and linting if applicable
+4. Report PASS if all must-haves are met, FAIL with specific gaps if not
+
+## Output Format
+
+For each must-have:
+- [PASS] or [FAIL]: description
+- If FAIL: what's missing and what needs to be done
+
+Final verdict: PASS or FAIL

package/dist/agents/backends/claude-code.d.ts

@@ -0,0 +1,2 @@
+import type { AgentRuntime } from '../runtime.js';
+export declare function createClaudeCodeRuntime(): AgentRuntime;

package/dist/agents/backends/claude-code.js

@@ -0,0 +1,215 @@
+import { spawn, execFile } from 'node:child_process';
+// Remove CLAUDECODE env var so spawned claude processes don't think they're nested
+function cleanEnv() {
+    const env = { ...process.env };
+    delete env.CLAUDECODE;
+    return env;
+}
+export function createClaudeCodeRuntime() {
+    const activeProcesses = new Map();
+    return {
+        type: 'claude-code',
+        async isAvailable() {
+            return new Promise((resolve) => {
+                execFile('claude', ['--version'], { env: cleanEnv() }, (error) => {
+                    resolve(error === null);
+                });
+            });
+        },
+        async *execute(params) {
+            const args = buildArgs(params);
+            const child = spawn('claude', args, {
+                cwd: params.workingDirectory,
+                stdio: ['pipe', 'pipe', 'pipe'],
+                env: cleanEnv(),
+            });
+            activeProcesses.set(params.executionId, child);
+            // Pipe prompt to stdin
+            if (child.stdin) {
+                child.stdin.write(params.prompt);
+                child.stdin.end();
+            }
+            try {
+                yield* parseNdjsonStream(child, params.executionId);
+            }
+            finally {
+                activeProcesses.delete(params.executionId);
+            }
+        },
+        async abort(executionId) {
+            const child = activeProcesses.get(executionId);
+            if (child) {
+                child.kill('SIGTERM');
+                activeProcesses.delete(executionId);
+            }
+        },
+    };
+}
+function buildArgs(params) {
+    const args = ['-p', '--output-format', 'stream-json'];
+    if (params.model !== undefined) {
+        args.push('--model', params.model);
+    }
+    if (params.maxTurns !== undefined) {
+        args.push('--max-turns', String(params.maxTurns));
+    }
+    if (params.allowedTools !== undefined && params.allowedTools.length > 0) {
+        args.push('--allowedTools', params.allowedTools.join(','));
+    }
+    if (params.systemPrompt !== undefined) {
+        args.push('--append-system-prompt', params.systemPrompt);
+    }
+    if (params.dangerouslySkipPermissions === true) {
+        args.push('--dangerously-skip-permissions');
+    }
+    return args;
+}
+async function* parseNdjsonStream(child, executionId) {
+    const stdout = child.stdout;
+    if (!stdout) {
+        yield { type: 'error', error: `No stdout for execution ${executionId}` };
+        return;
+    }
+    let buffer = '';
+    const events = [];
+    let done = false;
+    let resolveWait;
+    let error;
+    function onData(chunk) {
+        buffer += chunk.toString('utf-8');
+        const lines = buffer.split('\n');
+        buffer = lines.pop() ?? '';
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (trimmed === '')
+                continue;
+            try {
+                const parsed = JSON.parse(trimmed);
+                const mapped = mapClaudeEvent(parsed);
+                for (const event of mapped) {
+                    events.push(event);
+                }
+            }
+            catch {
+                // Skip malformed JSON lines
+            }
+        }
+        if (resolveWait) {
+            const r = resolveWait;
+            resolveWait = undefined;
+            r();
+        }
+    }
+    function onError(err) {
+        error = err.message;
+        done = true;
+        if (resolveWait) {
+            const r = resolveWait;
+            resolveWait = undefined;
+            r();
+        }
+    }
+    function onClose() {
+        // Process remaining buffer
+        if (buffer.trim() !== '') {
+            try {
+                const parsed = JSON.parse(buffer.trim());
+                const mapped = mapClaudeEvent(parsed);
+                for (const event of mapped) {
+                    events.push(event);
+                }
+            }
+            catch {
+                // Skip malformed final line
+            }
+        }
+        done = true;
+        if (resolveWait) {
+            const r = resolveWait;
+            resolveWait = undefined;
+            r();
+        }
+    }
+    stdout.on('data', onData);
+    child.on('error', onError);
+    child.on('close', onClose);
+    try {
+        while (true) {
+            while (events.length > 0) {
+                yield events.shift();
+            }
+            if (done)
+                break;
+            await new Promise((resolve) => {
+                resolveWait = resolve;
+            });
+        }
+        // Yield any remaining events
+        while (events.length > 0) {
+            yield events.shift();
+        }
+        if (error !== undefined) {
+            yield { type: 'error', error };
+        }
+    }
+    finally {
+        stdout.removeListener('data', onData);
+        child.removeListener('error', onError);
+        child.removeListener('close', onClose);
+    }
+}
+function mapClaudeEvent(raw) {
+    if (raw === null || typeof raw !== 'object')
+        return [];
+    const obj = raw;
+    const eventType = obj.type;
+    if (eventType === 'assistant') {
+        return mapAssistantEvent(obj);
+    }
+    if (eventType === 'tool_use') {
+        const tool = typeof obj.name === 'string' ? obj.name : 'unknown';
+        return [{ type: 'tool_use', tool, input: obj.input }];
+    }
+    if (eventType === 'tool_result') {
+        const tool = typeof obj.name === 'string' ? obj.name : 'unknown';
+        return [{ type: 'tool_result', tool, output: obj.output }];
+    }
+    if (eventType === 'result') {
+        const events = [];
+        const inputTokens = typeof obj.input_tokens === 'number' ? obj.input_tokens : 0;
+        const outputTokens = typeof obj.output_tokens === 'number' ? obj.output_tokens : 0;
+        events.push({
+            type: 'cost_update',
+            inputTokens,
+            outputTokens,
+        });
+        const result = typeof obj.result === 'string'
+            ? obj.result
+            : typeof obj.message === 'string'
+                ? obj.message
+                : '';
+        events.push({ type: 'complete', result });
+        return events;
+    }
+    return [];
+}
+function mapAssistantEvent(obj) {
+    const events = [];
+    const message = obj.message;
+    if (message !== null && typeof message === 'object') {
+        const msg = message;
+        const content = msg.content;
+        if (Array.isArray(content)) {
+            for (const block of content) {
+                if (block !== null && typeof block === 'object') {
+                    const b = block;
+                    if (b.type === 'text' && typeof b.text === 'string') {
+                        events.push({ type: 'text_delta', text: b.text });
+                    }
+                }
+            }
+        }
+    }
+    return events;
+}
+//# sourceMappingURL=claude-code.js.map

package/dist/agents/backends/claude-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-code.js","sourceRoot":"","sources":["../../../src/agents/backends/claude-code.ts"],"names":[],"mappings":"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"}

package/dist/agents/backends/mock.d.ts

@@ -0,0 +1,9 @@
+import type { AgentRuntime, AgentEvent } from '../runtime.js';
+export interface MockConfig {
+    readonly events?: readonly AgentEvent[];
+    readonly delay?: number;
+    readonly shouldFail?: boolean;
+    readonly errorMessage?: string;
+    readonly isAvailableResult?: boolean;
+}
+export declare function createMockRuntime(config: MockConfig): AgentRuntime;

package/dist/agents/backends/mock.js

@@ -0,0 +1,31 @@
+export function createMockRuntime(config) {
+    return {
+        type: 'mock',
+        async isAvailable() {
+            return config.isAvailableResult ?? true;
+        },
+        async *execute(_params) {
+            if (config.shouldFail === true) {
+                yield {
+                    type: 'error',
+                    error: config.errorMessage ?? 'Mock execution failed',
+                };
+                return;
+            }
+            const events = config.events ?? [];
+            for (const event of events) {
+                if (config.delay !== undefined && config.delay > 0) {
+                    await sleep(config.delay);
+                }
+                yield event;
+            }
+        },
+        async abort(_executionId) {
+            // no-op for mock
+        },
+    };
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+//# sourceMappingURL=mock.js.map

package/dist/agents/backends/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../../../src/agents/backends/mock.ts"],"names":[],"mappings":"AAUA,MAAM,UAAU,iBAAiB,CAAC,MAAkB;IAClD,OAAO;QACL,IAAI,EAAE,MAAM;QAEZ,KAAK,CAAC,WAAW;YACf,OAAO,MAAM,CAAC,iBAAiB,IAAI,IAAI,CAAC;QAC1C,CAAC;QAED,KAAK,CAAC,CAAC,OAAO,CAAC,OAA2B;YACxC,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;gBAC/B,MAAM;oBACJ,IAAI,EAAE,OAAO;oBACb,KAAK,EAAE,MAAM,CAAC,YAAY,IAAI,uBAAuB;iBACtD,CAAC;gBACF,OAAO;YACT,CAAC;YAED,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC;YACnC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;oBACnD,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBAC5B,CAAC;gBACD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;QAED,KAAK,CAAC,KAAK,CAAC,YAAoB;YAC9B,iBAAiB;QACnB,CAAC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/dist/agents/context-builder.d.ts

@@ -0,0 +1,10 @@
+import type { Task } from '../types.js';
+import type { StateStore } from '../state/store.js';
+export interface BuildContextParams {
+    readonly task: Task;
+    readonly store: StateStore;
+    readonly constitution?: string;
+    readonly dependencySummaries?: Record<string, string>;
+    readonly waveSummary?: string;
+}
+export declare function buildContext(params: BuildContextParams): Promise<string>;

package/dist/agents/context-builder.js

@@ -0,0 +1,61 @@
+export async function buildContext(params) {
+    const { task, store, constitution, dependencySummaries, waveSummary } = params;
+    const sections = [];
+    // Task header
+    sections.push(`# Task: ${task.title}`);
+    // Description
+    sections.push('## Description');
+    sections.push(task.description);
+    // Must-Haves
+    if (task.mustHaves.length > 0) {
+        sections.push('## Must-Haves');
+        sections.push(task.mustHaves.map((item) => `- ${item}`).join('\n'));
+    }
+    // Verification
+    if (task.verification) {
+        sections.push('## Verification');
+        sections.push(task.verification);
+    }
+    // Completed Dependency Outputs
+    if (dependencySummaries && Object.keys(dependencySummaries).length > 0) {
+        sections.push('## Completed Dependency Outputs');
+        for (const [key, summary] of Object.entries(dependencySummaries)) {
+            sections.push(`### ${key}`);
+            sections.push(summary);
+        }
+    }
+    // Previous Wave Summary
+    if (waveSummary) {
+        sections.push('## Previous Wave Summary');
+        sections.push(waveSummary);
+    }
+    // Project State
+    const stateContent = await safeRead(() => store.readState());
+    if (stateContent) {
+        sections.push('## Project State');
+        sections.push(stateContent);
+    }
+    // Project Context
+    const contextContent = await safeRead(() => store.readContext());
+    if (contextContent) {
+        sections.push('## Project Context');
+        sections.push(contextContent);
+    }
+    // Constitution
+    const constitutionContent = constitution ?? await safeRead(() => store.readConstitution());
+    if (constitutionContent) {
+        sections.push('## Constitution');
+        sections.push(constitutionContent);
+    }
+    return sections.join('\n\n');
+}
+async function safeRead(fn) {
+    try {
+        const content = await fn();
+        return content || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=context-builder.js.map

package/dist/agents/context-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-builder.js","sourceRoot":"","sources":["../../src/agents/context-builder.ts"],"names":[],"mappings":"AAWA,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAA0B;IAC3D,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAE/E,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,cAAc;IACd,QAAQ,CAAC,IAAI,CAAC,WAAW,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IAEvC,cAAc;IACd,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IAChC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAEhC,aAAa;IACb,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,QAAQ,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,eAAe;IACf,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACtB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACnC,CAAC;IAED,+BAA+B;IAC/B,IAAI,mBAAmB,IAAI,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvE,QAAQ,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QACjD,KAAK,MAAM,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE,CAAC;YACjE,QAAQ,CAAC,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,wBAAwB;IACxB,IAAI,WAAW,EAAE,CAAC;QAChB,QAAQ,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;IAC7B,CAAC;IAED,gBAAgB;IAChB,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC;IAC7D,IAAI,YAAY,EAAE,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;QAClC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IAC9B,CAAC;IAED,kBAAkB;IAClB,MAAM,cAAc,GAAG,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACjE,IAAI,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;QACpC,QAAQ,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAChC,CAAC;IAED,eAAe;IACf,MAAM,mBAAmB,GAAG,YAAY,IAAI,MAAM,QAAQ,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC;IAC3F,IAAI,mBAAmB,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACjC,QAAQ,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,EAAyB;IAC/C,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,EAAE,CAAC;QAC3B,OAAO,OAAO,IAAI,SAAS,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC"}