ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/mcp/core/init.js

@@ -0,0 +1,272 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { basename, join } from 'node:path';
+import YAML from 'yaml';
+import { detectBestAgent } from '../../loop/agents.js';
+function detectProject(cwd) {
+    // Node.js
+    if (existsSync(join(cwd, 'package.json'))) {
+        try {
+            const pkg = JSON.parse(readFileSync(join(cwd, 'package.json'), 'utf-8'));
+            const scripts = pkg.scripts || {};
+            return {
+                type: 'nodejs',
+                name: pkg.name || basename(cwd),
+                testCmd: scripts.test ? 'npm test' : undefined,
+                buildCmd: scripts.build ? 'npm run build' : undefined,
+                lintCmd: scripts.lint ? 'npm run lint' : undefined,
+            };
+        }
+        catch {
+            return { type: 'nodejs', name: basename(cwd) };
+        }
+    }
+    // Python
+    if (existsSync(join(cwd, 'pyproject.toml')) || existsSync(join(cwd, 'setup.py'))) {
+        return {
+            type: 'python',
+            name: basename(cwd),
+            testCmd: 'pytest',
+            lintCmd: 'ruff check .',
+        };
+    }
+    // Rust
+    if (existsSync(join(cwd, 'Cargo.toml'))) {
+        return {
+            type: 'rust',
+            name: basename(cwd),
+            testCmd: 'cargo test',
+            buildCmd: 'cargo build',
+            lintCmd: 'cargo clippy',
+        };
+    }
+    // Go
+    if (existsSync(join(cwd, 'go.mod'))) {
+        return {
+            type: 'go',
+            name: basename(cwd),
+            testCmd: 'go test ./...',
+            buildCmd: 'go build ./...',
+            lintCmd: 'golangci-lint run',
+        };
+    }
+    return { type: 'unknown', name: basename(cwd) };
+}
+function generateAgentsMd(project) {
+    const validationCmds = [project.testCmd, project.buildCmd, project.lintCmd].filter(Boolean);
+    return `# AGENTS.md
+
+This file defines how Ralph operates in this project.
+
+## Validation Commands
+
+Run these after each task to ensure quality:
+
+\`\`\`bash
+${validationCmds.length > 0 ? validationCmds.join('\n') : '# Add your test/build/lint commands here'}
+\`\`\`
+
+## Build Instructions
+
+${project.type === 'nodejs' ? '1. Run `npm install` to install dependencies\n2. Run `npm run build` to build (if applicable)\n3. Run `npm test` to verify' : ''}
+${project.type === 'python' ? '1. Create virtual environment: `python -m venv venv`\n2. Install dependencies: `pip install -e .`\n3. Run tests: `pytest`' : ''}
+${project.type === 'rust' ? '1. Run `cargo build` to compile\n2. Run `cargo test` to verify' : ''}
+${project.type === 'go' ? '1. Run `go mod tidy` to sync dependencies\n2. Run `go build ./...` to compile\n3. Run `go test ./...` to verify' : ''}
+${project.type === 'unknown' ? '1. Add your build instructions here' : ''}
+
+## Code Patterns
+
+- Follow existing code style
+- Add tests for new functionality
+- Keep functions small and focused
+- Use meaningful names
+
+## Task Completion
+
+A task is complete when:
+1. All validation commands pass
+2. Code is committed (if auto-commit enabled)
+3. No TODO comments left unaddressed
+`;
+}
+function generatePromptBuild() {
+    return `# Building Mode
+
+You are in BUILDING mode. Execute tasks from the implementation plan.
+
+## Process
+
+1. Read IMPLEMENTATION_PLAN.md for the current task
+2. Implement the task following patterns in AGENTS.md
+3. Run validation commands after each change
+4. If tests fail, fix the issues before moving on
+5. Mark the task as complete in IMPLEMENTATION_PLAN.md
+6. Move to the next task
+
+## Rules
+
+- One task at a time
+- Validate after each change
+- Commit working code only
+- Update the plan as you learn
+- Only link to pages that exist - use "#" for placeholder links
+- Use realistic placeholder data (names, dates, content)
+
+## Completion Signal
+
+When all tasks are done, output: <TASK_DONE>
+If blocked, output: <TASK_BLOCKED> with explanation
+`;
+}
+function generatePromptPlan() {
+    return `# Planning Mode
+
+You are in PLANNING mode. Analyze specs and create an implementation plan.
+
+## Process
+
+1. Read all files in specs/ folder
+2. Analyze existing codebase
+3. Identify gaps between specs and implementation
+4. Create prioritized task list in IMPLEMENTATION_PLAN.md
+
+## Task Format
+
+Each task in IMPLEMENTATION_PLAN.md should have:
+- [ ] Clear, actionable description
+- Acceptance criteria
+- Dependencies (if any)
+
+## Rules
+
+- Do NOT implement anything
+- Only analyze and plan
+- Keep tasks small (< 30 min each)
+- Order by dependencies
+
+## Output
+
+Update IMPLEMENTATION_PLAN.md with the task list.
+`;
+}
+function generateImplementationPlan() {
+    return `# Implementation Plan
+
+> Auto-generated by Ralph. Update as tasks complete.
+
+## Status
+
+- [ ] Task 1: (describe first task)
+- [ ] Task 2: (describe second task)
+
+## Notes
+
+Add discoveries and learnings here as you work.
+`;
+}
+function generateExampleSpec(projectName) {
+    return `# ${projectName} Specification
+
+## Overview
+
+Describe what this project does.
+
+## Features
+
+### Feature 1: (name)
+
+Description of the feature.
+
+**Acceptance Criteria:**
+- [ ] Criterion 1
+- [ ] Criterion 2
+
+### Feature 2: (name)
+
+Description of the feature.
+
+## Technical Requirements
+
+- List technical constraints
+- Performance requirements
+- Security considerations
+`;
+}
+/**
+ * Core initialization logic without CLI dependencies
+ */
+export async function initCore(options) {
+    const cwd = options.path;
+    const filesCreated = [];
+    try {
+        // Check if directory exists
+        if (!existsSync(cwd)) {
+            mkdirSync(cwd, { recursive: true });
+        }
+        // Check if already initialized
+        if (existsSync(join(cwd, 'AGENTS.md'))) {
+            return {
+                success: false,
+                path: cwd,
+                filesCreated: [],
+                error: 'Ralph Playbook files already exist',
+            };
+        }
+        // Detect project
+        const project = detectProject(cwd);
+        if (options.name) {
+            project.name = options.name;
+        }
+        // Detect agent
+        const agent = await detectBestAgent();
+        const agentType = agent?.type || 'claude-code';
+        // Create AGENTS.md
+        writeFileSync(join(cwd, 'AGENTS.md'), generateAgentsMd(project));
+        filesCreated.push('AGENTS.md');
+        // Create PROMPT files
+        writeFileSync(join(cwd, 'PROMPT_build.md'), generatePromptBuild());
+        filesCreated.push('PROMPT_build.md');
+        writeFileSync(join(cwd, 'PROMPT_plan.md'), generatePromptPlan());
+        filesCreated.push('PROMPT_plan.md');
+        // Create implementation plan
+        writeFileSync(join(cwd, 'IMPLEMENTATION_PLAN.md'), generateImplementationPlan());
+        filesCreated.push('IMPLEMENTATION_PLAN.md');
+        // Create specs folder with example
+        const specsDir = join(cwd, 'specs');
+        if (!existsSync(specsDir)) {
+            mkdirSync(specsDir, { recursive: true });
+            writeFileSync(join(specsDir, 'example.md'), generateExampleSpec(project.name));
+            filesCreated.push('specs/example.md');
+        }
+        // Create .ralph config
+        const ralphDir = join(cwd, '.ralph');
+        if (!existsSync(ralphDir)) {
+            mkdirSync(ralphDir, { recursive: true });
+            const config = {
+                agent: agentType,
+                auto_commit: true,
+                max_iterations: 50,
+                validation: {
+                    test: project.testCmd || null,
+                    build: project.buildCmd || null,
+                    lint: project.lintCmd || null,
+                },
+            };
+            writeFileSync(join(ralphDir, 'config.yaml'), YAML.stringify(config));
+            filesCreated.push('.ralph/config.yaml');
+        }
+        return {
+            success: true,
+            path: cwd,
+            filesCreated,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            path: cwd,
+            filesCreated,
+            error: error.message,
+        };
+    }
+}
+//# sourceMappingURL=init.js.map

package/dist/mcp/core/init.js.map

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

package/dist/mcp/core/plan.d.ts

@@ -0,0 +1,15 @@
+export interface PlanCoreOptions {
+    path: string;
+    auto?: boolean;
+}
+export interface PlanCoreResult {
+    success: boolean;
+    planPath: string;
+    taskCount: number;
+    error?: string;
+}
+/**
+ * Core planning logic without CLI dependencies
+ */
+export declare function planCore(options: PlanCoreOptions): Promise<PlanCoreResult>;
+//# sourceMappingURL=plan.d.ts.map

package/dist/mcp/core/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/plan.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,CAAC,CA4FhF"}

package/dist/mcp/core/plan.js

@@ -0,0 +1,90 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectBestAgent, runAgent } from '../../loop/agents.js';
+/**
+ * Core planning logic without CLI dependencies
+ */
+export async function planCore(options) {
+    const cwd = options.path;
+    const planPath = join(cwd, 'IMPLEMENTATION_PLAN.md');
+    try {
+        // Check for Ralph Playbook files
+        const promptPlanPath = join(cwd, 'PROMPT_plan.md');
+        const specsDir = join(cwd, 'specs');
+        if (!existsSync(promptPlanPath)) {
+            return {
+                success: false,
+                planPath,
+                taskCount: 0,
+                error: 'Ralph Playbook not found. Run init first.',
+            };
+        }
+        if (!existsSync(specsDir)) {
+            return {
+                success: false,
+                planPath,
+                taskCount: 0,
+                error: 'No specs/ folder found. Create specs first.',
+            };
+        }
+        // Read planning prompt
+        const planPrompt = readFileSync(promptPlanPath, 'utf-8');
+        // Detect agent
+        const agent = await detectBestAgent();
+        if (!agent) {
+            return {
+                success: false,
+                planPath,
+                taskCount: 0,
+                error: 'No coding agent found.',
+            };
+        }
+        // Build the full prompt
+        const fullPrompt = `${planPrompt}
+
+Please analyze the specs/ folder and update IMPLEMENTATION_PLAN.md with a prioritized task list.
+
+Focus on:
+1. Reading all specification files in specs/
+2. Understanding the current codebase state
+3. Identifying gaps between specs and implementation
+4. Creating actionable, small tasks
+
+Do not implement anything - only plan.`;
+        // Run the agent in planning mode
+        const result = await runAgent(agent, {
+            task: fullPrompt,
+            cwd,
+            auto: options.auto,
+            maxTurns: 5, // Limited turns for planning
+        });
+        if (result.exitCode !== 0) {
+            return {
+                success: false,
+                planPath,
+                taskCount: 0,
+                error: `Planning failed: ${result.output.slice(0, 200)}`,
+            };
+        }
+        // Count tasks in the plan
+        let taskCount = 0;
+        if (existsSync(planPath)) {
+            const planContent = readFileSync(planPath, 'utf-8');
+            taskCount = (planContent.match(/- \[[ x]\]/g) || []).length;
+        }
+        return {
+            success: true,
+            planPath,
+            taskCount,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            planPath,
+            taskCount: 0,
+            error: error.message,
+        };
+    }
+}
+//# sourceMappingURL=plan.js.map

package/dist/mcp/core/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/mcp/core/plan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAcjE;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,OAAwB;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IACzB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IAErD,IAAI,CAAC;QACH,iCAAiC;QACjC,MAAM,cAAc,GAAG,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAEpC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,2CAA2C;aACnD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,6CAA6C;aACrD,CAAC;QACJ,CAAC;QAED,uBAAuB;QACvB,MAAM,UAAU,GAAG,YAAY,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;QAEzD,eAAe;QACf,MAAM,KAAK,GAAG,MAAM,eAAe,EAAE,CAAC;QAEtC,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,wBAAwB;aAChC,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,GAAG,UAAU;;;;;;;;;;uCAUG,CAAC;QAEpC,iCAAiC;QACjC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,KAAK,EAAE;YACnC,IAAI,EAAE,UAAU;YAChB,GAAG;YACH,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,QAAQ,EAAE,CAAC,EAAE,6BAA6B;SAC3C,CAAC,CAAC;QAEH,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,QAAQ;gBACR,SAAS,EAAE,CAAC;gBACZ,KAAK,EAAE,oBAAoB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;aACzD,CAAC;QACJ,CAAC;QAED,0BAA0B;QAC1B,IAAI,SAAS,GAAG,CAAC,CAAC;QAClB,IAAI,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YACzB,MAAM,WAAW,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACpD,SAAS,GAAG,CAAC,WAAW,CAAC,KAAK,CAAC,aAAa,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC;QAC9D,CAAC;QAED,OAAO;YACL,OAAO,EAAE,IAAI;YACb,QAAQ;YACR,SAAS;SACV,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,QAAQ;YACR,SAAS,EAAE,CAAC;YACZ,KAAK,EAAG,KAAe,CAAC,OAAO;SAChC,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/mcp/core/run.d.ts

@@ -0,0 +1,26 @@
+export interface RunCoreOptions {
+    path: string;
+    task?: string;
+    auto?: boolean;
+    commit?: boolean;
+    push?: boolean;
+    pr?: boolean;
+    validate?: boolean;
+    maxIterations?: number;
+    from?: string;
+    project?: string;
+    label?: string;
+    status?: string;
+    limit?: number;
+}
+export interface RunCoreResult {
+    success: boolean;
+    iterations: number;
+    commits: string[];
+    error?: string;
+}
+/**
+ * Core run logic without CLI dependencies
+ */
+export declare function runCore(options: RunCoreOptions): Promise<RunCoreResult>;
+//# sourceMappingURL=run.d.ts.map

package/dist/mcp/core/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../../src/mcp/core/run.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAsH7E"}

package/dist/mcp/core/run.js

@@ -0,0 +1,114 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { detectBestAgent } from '../../loop/agents.js';
+import { runLoop } from '../../loop/executor.js';
+import { fetchFromSource } from '../../sources/index.js';
+/**
+ * Core run logic without CLI dependencies
+ */
+export async function runCore(options) {
+    const cwd = options.path;
+    try {
+        // Handle --from source
+        let sourceSpec = null;
+        if (options.from) {
+            const result = await fetchFromSource(options.from, {
+                project: options.project,
+                label: options.label,
+                status: options.status,
+                limit: options.limit,
+            });
+            sourceSpec = result.content;
+            // Write to specs directory
+            const specsDir = join(cwd, 'specs');
+            if (!existsSync(specsDir)) {
+                mkdirSync(specsDir, { recursive: true });
+            }
+            const specFilename = result.title
+                ? `${result.title.toLowerCase().replace(/[^a-z0-9]+/g, '-')}.md`
+                : 'source-spec.md';
+            writeFileSync(join(specsDir, specFilename), sourceSpec);
+        }
+        // Detect agent
+        const agent = await detectBestAgent();
+        if (!agent) {
+            return {
+                success: false,
+                iterations: 0,
+                commits: [],
+                error: 'No coding agent found.',
+            };
+        }
+        // Check for Ralph Playbook files
+        const buildPromptPath = join(cwd, 'PROMPT_build.md');
+        const implementationPlanPath = join(cwd, 'IMPLEMENTATION_PLAN.md');
+        const hasPlaybook = existsSync(buildPromptPath) && existsSync(implementationPlanPath);
+        // Get task
+        let finalTask = options.task;
+        let isBuildMode = false;
+        // If we fetched from a source, use that as the task
+        if (sourceSpec && !finalTask) {
+            finalTask = `Build the following project based on this specification:
+
+${sourceSpec}
+
+Analyze the specification and implement all required features. Create a proper project structure with all necessary files.`;
+        }
+        if (!finalTask) {
+            // Check for Ralph Playbook build mode
+            if (hasPlaybook) {
+                const buildPrompt = readFileSync(buildPromptPath, 'utf-8');
+                const implementationPlan = readFileSync(implementationPlanPath, 'utf-8');
+                finalTask = `${buildPrompt}
+
+## Current Implementation Plan
+
+${implementationPlan}
+
+Work through the tasks in the implementation plan. Mark tasks as complete as you finish them.
+Focus on one task at a time. After completing a task, update IMPLEMENTATION_PLAN.md.`;
+                isBuildMode = true;
+            }
+            else {
+                return {
+                    success: false,
+                    iterations: 0,
+                    commits: [],
+                    error: 'No task provided and no Ralph Playbook found.',
+                };
+            }
+        }
+        // Run the loop
+        const prTitle = isBuildMode
+            ? 'Ralph: Implementation from plan'
+            : `Ralph: ${finalTask.slice(0, 50)}`;
+        const loopOptions = {
+            task: finalTask,
+            cwd,
+            agent,
+            maxIterations: options.maxIterations || 50,
+            auto: options.auto,
+            commit: options.commit,
+            push: options.push,
+            pr: options.pr,
+            prTitle,
+            validate: options.validate,
+        };
+        const result = await runLoop(loopOptions);
+        return {
+            success: result.success,
+            iterations: result.iterations,
+            commits: result.commits,
+            error: result.error,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            iterations: 0,
+            commits: [],
+            error: error.message,
+        };
+    }
+}
+//# sourceMappingURL=run.js.map

package/dist/mcp/core/run.js.map

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

package/dist/mcp/prompts.d.ts

@@ -0,0 +1,10 @@
+import type { GetPromptResult, Prompt } from '@modelcontextprotocol/sdk/types.js';
+/**
+ * Pre-built workflow prompts for ralph-starter
+ */
+export declare function getPrompts(): Prompt[];
+/**
+ * Get a specific prompt with arguments filled in
+ */
+export declare function handleGetPrompt(name: string, args?: Record<string, string>): GetPromptResult;
+//# sourceMappingURL=prompts.d.ts.map

package/dist/mcp/prompts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/mcp/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAElF;;GAEG;AACH,wBAAgB,UAAU,IAAI,MAAM,EAAE,CA8DrC;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,eAAe,CAiG5F"}