ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/mcp/tools.js

@@ -0,0 +1,316 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { z } from 'zod';
+// Import core functions (these will be created/extracted)
+import { initCore } from './core/init.js';
+import { planCore } from './core/plan.js';
+import { runCore } from './core/run.js';
+/**
+ * Tool definitions for ralph-starter MCP server
+ */
+const toolSchemas = {
+    ralph_init: z.object({
+        path: z.string().describe('Project path to initialize'),
+        name: z.string().optional().describe('Project name'),
+    }),
+    ralph_plan: z.object({
+        path: z.string().describe('Project path'),
+        auto: z.boolean().optional().describe('Run in automated mode'),
+    }),
+    ralph_run: z.object({
+        path: z.string().describe('Project path'),
+        task: z.string().optional().describe('Task to execute'),
+        auto: z.boolean().optional().describe('Run in automated mode'),
+        commit: z.boolean().optional().describe('Auto-commit changes'),
+        validate: z.boolean().optional().describe('Run validation after changes'),
+        from: z.string().optional().describe('Source to fetch spec from'),
+        project: z.string().optional().describe('Project filter for source'),
+        label: z.string().optional().describe('Label filter for source'),
+    }),
+    ralph_status: z.object({
+        path: z.string().describe('Project path'),
+    }),
+    ralph_validate: z.object({
+        path: z.string().describe('Project path'),
+    }),
+};
+/**
+ * Get all available tools
+ */
+export function getTools() {
+    return [
+        {
+            name: 'ralph_init',
+            description: 'Initialize Ralph Playbook in a project. Creates AGENTS.md, PROMPT_plan.md, PROMPT_build.md, specs/, and IMPLEMENTATION_PLAN.md.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Project path to initialize',
+                    },
+                    name: {
+                        type: 'string',
+                        description: 'Project name',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+        {
+            name: 'ralph_plan',
+            description: 'Create an implementation plan from specs. Analyzes specs/ directory and generates IMPLEMENTATION_PLAN.md.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Project path',
+                    },
+                    auto: {
+                        type: 'boolean',
+                        description: 'Run in automated mode (skip permissions)',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+        {
+            name: 'ralph_run',
+            description: 'Execute an autonomous coding loop. Uses the implementation plan and agents to build the project.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Project path',
+                    },
+                    task: {
+                        type: 'string',
+                        description: 'Task to execute (optional if using Ralph Playbook)',
+                    },
+                    auto: {
+                        type: 'boolean',
+                        description: 'Run in automated mode (skip permissions)',
+                    },
+                    commit: {
+                        type: 'boolean',
+                        description: 'Auto-commit changes after each task',
+                    },
+                    validate: {
+                        type: 'boolean',
+                        description: 'Run tests/lint/build validation',
+                    },
+                    from: {
+                        type: 'string',
+                        description: 'Source to fetch spec from (file, url, github, todoist, linear, notion)',
+                    },
+                    project: {
+                        type: 'string',
+                        description: 'Project/repo name for source integrations',
+                    },
+                    label: {
+                        type: 'string',
+                        description: 'Label filter for source integrations',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+        {
+            name: 'ralph_status',
+            description: 'Check Ralph Playbook status. Shows available files, implementation progress, and agent availability.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Project path',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+        {
+            name: 'ralph_validate',
+            description: 'Run validation commands (tests, lint, build). Checks project health and reports issues.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    path: {
+                        type: 'string',
+                        description: 'Project path',
+                    },
+                },
+                required: ['path'],
+            },
+        },
+    ];
+}
+/**
+ * Handle a tool call
+ */
+export async function handleToolCall(name, args) {
+    try {
+        switch (name) {
+            case 'ralph_init':
+                return await handleInit(args);
+            case 'ralph_plan':
+                return await handlePlan(args);
+            case 'ralph_run':
+                return await handleRun(args);
+            case 'ralph_status':
+                return await handleStatus(args);
+            case 'ralph_validate':
+                return await handleValidate(args);
+            default:
+                return {
+                    content: [
+                        {
+                            type: 'text',
+                            text: `Unknown tool: ${name}`,
+                        },
+                    ],
+                };
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error.message}`,
+                },
+            ],
+        };
+    }
+}
+async function handleInit(args) {
+    const parsed = toolSchemas.ralph_init.parse(args);
+    const result = await initCore({
+        path: parsed.path,
+        name: parsed.name,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: formatInitResult(result),
+            },
+        ],
+    };
+}
+async function handlePlan(args) {
+    const parsed = toolSchemas.ralph_plan.parse(args);
+    const result = await planCore({
+        path: parsed.path,
+        auto: parsed.auto,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: formatPlanResult(result),
+            },
+        ],
+    };
+}
+async function handleRun(args) {
+    const parsed = toolSchemas.ralph_run.parse(args);
+    const result = await runCore({
+        path: parsed.path,
+        task: parsed.task,
+        auto: parsed.auto,
+        commit: parsed.commit,
+        validate: parsed.validate,
+        from: parsed.from,
+        project: parsed.project,
+        label: parsed.label,
+    });
+    return {
+        content: [
+            {
+                type: 'text',
+                text: formatRunResult(result),
+            },
+        ],
+    };
+}
+async function handleStatus(args) {
+    const parsed = toolSchemas.ralph_status.parse(args);
+    const path = parsed.path;
+    // Check for Ralph Playbook files
+    const files = {
+        'AGENTS.md': existsSync(join(path, 'AGENTS.md')),
+        'PROMPT_plan.md': existsSync(join(path, 'PROMPT_plan.md')),
+        'PROMPT_build.md': existsSync(join(path, 'PROMPT_build.md')),
+        'IMPLEMENTATION_PLAN.md': existsSync(join(path, 'IMPLEMENTATION_PLAN.md')),
+        'specs/': existsSync(join(path, 'specs')),
+    };
+    const hasPlaybook = files['AGENTS.md'] && files['IMPLEMENTATION_PLAN.md'];
+    // Read implementation plan if exists
+    let planProgress = '';
+    if (files['IMPLEMENTATION_PLAN.md']) {
+        const planContent = readFileSync(join(path, 'IMPLEMENTATION_PLAN.md'), 'utf-8');
+        const completedTasks = (planContent.match(/- \[x\]/gi) || []).length;
+        const totalTasks = (planContent.match(/- \[[ x]\]/gi) || []).length;
+        planProgress = `${completedTasks}/${totalTasks} tasks completed`;
+    }
+    // List specs if directory exists
+    let specs = [];
+    if (files['specs/']) {
+        specs = readdirSync(join(path, 'specs')).filter((f) => f.endsWith('.md'));
+    }
+    const status = {
+        hasPlaybook,
+        files,
+        planProgress,
+        specs,
+    };
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify(status, null, 2),
+            },
+        ],
+    };
+}
+async function handleValidate(args) {
+    const parsed = toolSchemas.ralph_validate.parse(args);
+    // Import validation functions
+    const { detectValidationCommands, runAllValidations } = await import('../loop/validation.js');
+    const commands = detectValidationCommands(parsed.path);
+    const results = await runAllValidations(parsed.path, commands);
+    return {
+        content: [
+            {
+                type: 'text',
+                text: JSON.stringify({ commands, results }, null, 2),
+            },
+        ],
+    };
+}
+function formatInitResult(result) {
+    if (result.success) {
+        return `Successfully initialized Ralph Playbook at ${result.path}\n\nFiles created:\n${result.filesCreated.map((f) => `- ${f}`).join('\n')}`;
+    }
+    return `Failed to initialize: ${result.error}`;
+}
+function formatPlanResult(result) {
+    if (result.success) {
+        return `Implementation plan created at ${result.planPath}\n\nTasks: ${result.taskCount}`;
+    }
+    return `Failed to create plan: ${result.error}`;
+}
+function formatRunResult(result) {
+    if (result.success) {
+        let text = `Loop completed successfully!\n\nIterations: ${result.iterations}`;
+        if (result.commits.length > 0) {
+            text += `\nCommits: ${result.commits.length}`;
+        }
+        return text;
+    }
+    return `Loop failed: ${result.error}`;
+}
+//# sourceMappingURL=tools.js.map

package/dist/mcp/tools.js.map

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

package/dist/presets/index.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Workflow Presets for Ralph Loop
+ * Pre-configured settings for common development scenarios
+ */
+export interface PresetConfig {
+    name: string;
+    description: string;
+    maxIterations: number;
+    validate: boolean;
+    commit: boolean;
+    completionPromise?: string;
+    promptPrefix?: string;
+    rateLimit?: number;
+    circuitBreaker?: {
+        maxConsecutiveFailures: number;
+        maxSameErrorCount: number;
+    };
+}
+export declare const PRESETS: Record<string, PresetConfig>;
+/**
+ * Get a preset by name
+ */
+export declare function getPreset(name: string): PresetConfig | undefined;
+/**
+ * Get all available preset names
+ */
+export declare function getPresetNames(): string[];
+/**
+ * Get presets grouped by category
+ */
+export declare function getPresetsByCategory(): Record<string, PresetConfig[]>;
+/**
+ * Format presets for CLI help
+ */
+export declare function formatPresetsHelp(): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/presets/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/presets/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,OAAO,CAAC;IAChB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE;QACf,sBAAsB,EAAE,MAAM,CAAC;QAC/B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;CACH;AAED,eAAO,MAAM,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAqNhD,CAAC;AAEF;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,EAAE,CAEzC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CAqBrE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAa1C"}

package/dist/presets/index.js

@@ -0,0 +1,236 @@
+/**
+ * Workflow Presets for Ralph Loop
+ * Pre-configured settings for common development scenarios
+ */
+export const PRESETS = {
+    // Development presets
+    feature: {
+        name: 'feature',
+        description: 'Standard feature implementation with validation and commits',
+        maxIterations: 30,
+        validate: true,
+        commit: true,
+        completionPromise: 'FEATURE_COMPLETE',
+        circuitBreaker: {
+            maxConsecutiveFailures: 3,
+            maxSameErrorCount: 5,
+        },
+    },
+    'feature-minimal': {
+        name: 'feature-minimal',
+        description: 'Quick feature implementation without validation',
+        maxIterations: 20,
+        validate: false,
+        commit: true,
+    },
+    'tdd-red-green': {
+        name: 'tdd-red-green',
+        description: 'Test-driven development: write failing test, then implement',
+        maxIterations: 50,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Follow strict TDD: 1) Write a failing test first, 2) Run tests to confirm failure, 3) Implement minimum code to pass, 4) Refactor if needed. Commit after each green test.',
+        circuitBreaker: {
+            maxConsecutiveFailures: 5,
+            maxSameErrorCount: 3,
+        },
+    },
+    'spec-driven': {
+        name: 'spec-driven',
+        description: 'Implementation driven by specification files',
+        maxIterations: 40,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Read the specification files in specs/ directory. Implement according to the requirements. Mark tasks complete in IMPLEMENTATION_PLAN.md as you finish them.',
+        completionPromise: '<promise>COMPLETE</promise>',
+    },
+    refactor: {
+        name: 'refactor',
+        description: 'Safe refactoring with continuous test validation',
+        maxIterations: 40,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Refactor the code while maintaining all tests passing. Make small, incremental changes. Commit after each successful refactoring step.',
+        circuitBreaker: {
+            maxConsecutiveFailures: 2,
+            maxSameErrorCount: 3,
+        },
+    },
+    // Debugging presets
+    debug: {
+        name: 'debug',
+        description: 'Debugging session without auto-commits',
+        maxIterations: 20,
+        validate: false,
+        commit: false,
+        promptPrefix: 'Debug the issue step by step. Add logging, analyze outputs, identify root cause. Document findings.',
+    },
+    'incident-response': {
+        name: 'incident-response',
+        description: 'Quick fix for production incidents',
+        maxIterations: 15,
+        validate: true,
+        commit: true,
+        promptPrefix: 'This is a production incident. Focus on the minimal fix. Avoid refactoring. Document the issue and solution.',
+        circuitBreaker: {
+            maxConsecutiveFailures: 2,
+            maxSameErrorCount: 2,
+        },
+    },
+    'code-archaeology': {
+        name: 'code-archaeology',
+        description: 'Investigate and document legacy code',
+        maxIterations: 30,
+        validate: false,
+        commit: false,
+        promptPrefix: 'Investigate the codebase to understand how it works. Add documentation and comments. Create diagrams if helpful.',
+    },
+    // Review presets
+    review: {
+        name: 'review',
+        description: 'Code review and suggestions',
+        maxIterations: 10,
+        validate: true,
+        commit: false,
+        promptPrefix: 'Review the code for: bugs, security issues, performance problems, code quality. Suggest improvements but do not implement.',
+    },
+    'pr-review': {
+        name: 'pr-review',
+        description: 'Pull request review',
+        maxIterations: 10,
+        validate: true,
+        commit: false,
+        promptPrefix: 'Review the changes in this PR. Check for: correctness, test coverage, documentation, breaking changes. Provide actionable feedback.',
+    },
+    'adversarial-review': {
+        name: 'adversarial-review',
+        description: 'Security-focused adversarial review',
+        maxIterations: 15,
+        validate: false,
+        commit: false,
+        promptPrefix: 'Perform an adversarial security review. Look for: injection vulnerabilities, authentication bypasses, authorization issues, data leaks, OWASP Top 10.',
+    },
+    // Documentation presets
+    docs: {
+        name: 'docs',
+        description: 'Generate documentation',
+        maxIterations: 20,
+        validate: false,
+        commit: true,
+        promptPrefix: 'Generate comprehensive documentation. Include: API docs, usage examples, architecture overview. Use clear language.',
+    },
+    'documentation-first': {
+        name: 'documentation-first',
+        description: 'Write docs before implementation',
+        maxIterations: 30,
+        validate: false,
+        commit: true,
+        promptPrefix: 'Write documentation first, then implement. Document: purpose, API, usage examples, edge cases. Implementation must match documentation.',
+    },
+    // Specialized presets
+    'api-design': {
+        name: 'api-design',
+        description: 'API design and implementation',
+        maxIterations: 35,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Design and implement the API following REST best practices. Include: proper HTTP methods, status codes, error handling, validation, documentation.',
+    },
+    'migration-safety': {
+        name: 'migration-safety',
+        description: 'Safe database/data migrations',
+        maxIterations: 25,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Create safe migrations. Ensure: reversibility, no data loss, backward compatibility, proper testing. Create rollback scripts.',
+        circuitBreaker: {
+            maxConsecutiveFailures: 1,
+            maxSameErrorCount: 2,
+        },
+    },
+    'performance-optimization': {
+        name: 'performance-optimization',
+        description: 'Performance analysis and optimization',
+        maxIterations: 30,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Analyze and optimize performance. Profile first, identify bottlenecks, make targeted improvements. Document performance gains.',
+    },
+    'scientific-method': {
+        name: 'scientific-method',
+        description: 'Hypothesis-driven development',
+        maxIterations: 40,
+        validate: true,
+        commit: true,
+        promptPrefix: 'Follow the scientific method: 1) Observe the problem, 2) Form a hypothesis, 3) Design an experiment (test), 4) Implement and test, 5) Analyze results, 6) Iterate.',
+    },
+    research: {
+        name: 'research',
+        description: 'Research and exploration',
+        maxIterations: 25,
+        validate: false,
+        commit: false,
+        promptPrefix: 'Research the topic thoroughly. Explore options, compare alternatives, document findings. Create a summary report.',
+    },
+    'gap-analysis': {
+        name: 'gap-analysis',
+        description: 'Compare spec to implementation',
+        maxIterations: 20,
+        validate: true,
+        commit: false,
+        promptPrefix: 'Compare the specification to the current implementation. Identify gaps, missing features, and discrepancies. Create a prioritized TODO list.',
+    },
+};
+/**
+ * Get a preset by name
+ */
+export function getPreset(name) {
+    return PRESETS[name];
+}
+/**
+ * Get all available preset names
+ */
+export function getPresetNames() {
+    return Object.keys(PRESETS);
+}
+/**
+ * Get presets grouped by category
+ */
+export function getPresetsByCategory() {
+    return {
+        Development: [
+            PRESETS.feature,
+            PRESETS['feature-minimal'],
+            PRESETS['tdd-red-green'],
+            PRESETS['spec-driven'],
+            PRESETS.refactor,
+        ],
+        Debugging: [PRESETS.debug, PRESETS['incident-response'], PRESETS['code-archaeology']],
+        Review: [PRESETS.review, PRESETS['pr-review'], PRESETS['adversarial-review']],
+        Documentation: [PRESETS.docs, PRESETS['documentation-first']],
+        Specialized: [
+            PRESETS['api-design'],
+            PRESETS['migration-safety'],
+            PRESETS['performance-optimization'],
+            PRESETS['scientific-method'],
+            PRESETS.research,
+            PRESETS['gap-analysis'],
+        ],
+    };
+}
+/**
+ * Format presets for CLI help
+ */
+export function formatPresetsHelp() {
+    const categories = getPresetsByCategory();
+    const lines = ['Available presets:', ''];
+    for (const [category, presets] of Object.entries(categories)) {
+        lines.push(`  ${category}:`);
+        for (const preset of presets) {
+            lines.push(`    ${preset.name.padEnd(22)} ${preset.description}`);
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=index.js.map

package/dist/presets/index.js.map

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

package/dist/setup/agent-detector.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Agent Detection for ralph-starter
+ * Detects installed AI coding agents (Claude Code, OpenCode, Codex, Aider)
+ */
+export interface AgentInfo {
+    id: string;
+    name: string;
+    command: string;
+    versionFlag: string;
+    description: string;
+}
+export interface AgentDetectionResult {
+    id: string;
+    name: string;
+    available: boolean;
+    version?: string;
+    executablePath?: string;
+    error?: string;
+}
+/**
+ * List of supported AI agents
+ */
+export declare const SUPPORTED_AGENTS: AgentInfo[];
+/**
+ * Detect a single agent
+ */
+export declare function detectAgent(agent: AgentInfo): Promise<AgentDetectionResult>;
+/**
+ * Detect all supported agents
+ */
+export declare function detectAllAgents(): Promise<AgentDetectionResult[]>;
+/**
+ * Get the first available agent
+ */
+export declare function getFirstAvailableAgent(): Promise<AgentDetectionResult | null>;
+/**
+ * Check if Claude Code CLI is available
+ */
+export declare function isClaudeCodeAvailable(): Promise<AgentDetectionResult>;
+/**
+ * Quick test to verify Claude Code CLI is functional
+ * Uses --version which is fast and doesn't require authentication
+ */
+export declare function testClaudeCodeConnection(): Promise<{
+    success: boolean;
+    responseTime?: number;
+    error?: string;
+}>;
+/**
+ * Full test with actual LLM prompt (slower, requires auth)
+ */
+export declare function testClaudeCodeWithPrompt(): Promise<{
+    success: boolean;
+    responseTime?: number;
+    error?: string;
+}>;
+//# sourceMappingURL=agent-detector.d.ts.map

package/dist/setup/agent-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-detector.d.ts","sourceRoot":"","sources":["../../src/setup/agent-detector.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,EA6BvC,CAAC;AAoCF;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAqBjF;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAGvE;AAED;;GAEG;AACH,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAGnF;AAED;;GAEG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,oBAAoB,CAAC,CAG3E;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA0BD;AAED;;GAEG;AACH,wBAAsB,wBAAwB,IAAI,OAAO,CAAC;IACxD,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CA6BD"}