wiggum-cli 0.2.6 → 0.3.0

package/README.md

@@ -1,14 +1,21 @@
-# ralph-cli
+# wiggum-cli
 
 **AI-powered feature development loop CLI** - Auto-detect your tech stack and generate intelligent development environments.
 
 ```
- ██████╗   █████╗  ██╗      ██████╗  ██╗  ██╗
- ██╔══██╗ ██╔══██╗ ██║      ██╔══██╗ ██║  ██║
- ██████╔╝ ███████║ ██║      ██████╔╝ ███████║
- ██╔══██╗ ██╔══██║ ██║      ██╔═══╝  ██╔══██║
- ██║  ██║ ██║  ██║ ███████╗ ██║      ██║  ██║
- ╚═╝  ╚═╝ ╚═╝  ╚═╝ ╚══════╝ ╚═╝      ╚═╝  ╚═╝
+ ██╗    ██╗ ██╗  ██████╗   ██████╗  ██╗   ██╗ ███╗   ███╗
+ ██║    ██║ ██║ ██╔════╝  ██╔════╝  ██║   ██║ ████╗ ████║
+ ██║ █╗ ██║ ██║ ██║  ███╗ ██║  ███╗ ██║   ██║ ██╔████╔██║
+ ██║███╗██║ ██║ ██║   ██║ ██║   ██║ ██║   ██║ ██║╚██╔╝██║
+ ╚███╔███╔╝ ██║ ╚██████╔╝ ╚██████╔╝ ╚██████╔╝ ██║ ╚═╝ ██║
+  ╚══╝╚══╝  ╚═╝  ╚═════╝   ╚═════╝   ╚═════╝  ╚═╝     ╚═╝
+
+  ██████╗ ██╗      ██╗
+ ██╔════╝ ██║      ██║
+ ██║      ██║      ██║
+ ██║      ██║      ██║
+ ╚██████╗ ███████╗ ██║
+  ╚═════╝ ╚══════╝ ╚═╝
 ```
 *Simpson Yellow (#FED90F) branding*
 
@@ -16,68 +23,67 @@
 
 ```bash
 # Initialize in your project (recommended)
-npx ralph-cli init
+npx wiggum-cli init
 
 # Or install globally
-npm install -g ralph-cli
+npm install -g wiggum-cli
 ```
 
 ## Quick Start
 
 ```bash
-# 1. Initialize Ralph in your project
-npx ralph-cli init
+# 1. Initialize Wiggum in your project
+npx wiggum-cli init
 
 # 2. Create a new feature specification
-ralph new my-feature
+wiggum new my-feature
 
 # 3. Edit the spec file (opens in your editor)
-ralph new my-feature --edit
+wiggum new my-feature --edit
 
 # 4. Run the feature development loop
-ralph run my-feature
+wiggum run my-feature
 
 # 5. Monitor progress in real-time
-ralph monitor my-feature
+wiggum monitor my-feature
 ```
 
 ## Commands
 
-### `ralph init`
+### `wiggum init`
 
-Initialize Ralph in the current project. Scans your codebase to detect the tech stack and generates configuration files.
+Initialize Wiggum in the current project. Uses AI to analyze your codebase, detect the tech stack, and generate intelligent configuration files.
 
 ```bash
-ralph init [options]
+wiggum init [options]
 ```
 
 **Options:**
 | Flag | Description |
 |------|-------------|
-| `--ai` | Enable AI-enhanced analysis for deeper insights |
 | `--provider <name>` | AI provider: `anthropic`, `openai`, or `openrouter` (default: `anthropic`) |
 | `-y, --yes` | Accept defaults and skip confirmations |
 
 **Examples:**
 ```bash
-# Basic initialization with interactive prompts
-ralph init
+# Initialize with AI analysis (interactive)
+wiggum init
 
-# Initialize with AI enhancement using Anthropic
-ralph init --ai
+# Initialize with OpenAI provider
+wiggum init --provider openai
 
-# Initialize with OpenAI provider, skip confirmations
-ralph init --ai --provider openai --yes
+# Non-interactive mode (for CI/scripts)
+wiggum init --yes
 ```
 
 ---
 
-### `ralph run <feature>`
+### `wiggum run <feature>`
 
 Run the feature development loop for a specific feature. Executes the AI-driven implementation workflow.
 
 ```bash
-ralph run <feature> [options]
+wiggum run <feature> [options]
 ```
 
 **Options:**
@@ -92,26 +98,26 @@ ralph run <feature> [options]
 **Examples:**
 ```bash
 # Run the feature loop
-ralph run user-authentication
+wiggum run user-authentication
 
 # Run with git worktree isolation
-ralph run payment-flow --worktree
+wiggum run payment-flow --worktree
 
 # Resume an interrupted session
-ralph run payment-flow --resume
+wiggum run payment-flow --resume
 
 # Use specific model with iteration limits
-ralph run my-feature --model opus --max-iterations 30
+wiggum run my-feature --model opus --max-iterations 30
 ```
 
 ---
 
-### `ralph monitor <feature>`
+### `wiggum monitor <feature>`
 
 Launch the monitoring dashboard to track feature development progress in real-time.
 
 ```bash
-ralph monitor <feature> [options]
+wiggum monitor <feature> [options]
 ```
 
 **Options:**
@@ -124,23 +130,23 @@ ralph monitor <feature> [options]
 **Examples:**
 ```bash
 # Monitor with default settings
-ralph monitor user-authentication
+wiggum monitor user-authentication
 
 # Monitor with faster refresh rate
-ralph monitor my-feature --interval 2
+wiggum monitor my-feature --interval 2
 
 # Use bash monitor script
-ralph monitor my-feature --bash
+wiggum monitor my-feature --bash
 ```
 
 ---
 
-### `ralph new <feature>`
+### `wiggum new <feature>`
 
 Create a new feature specification from template.
 
 ```bash
-ralph new <feature> [options]
+wiggum new <feature> [options]
 ```
 
 **Options:**
@@ -154,21 +160,21 @@ ralph new <feature> [options]
 **Examples:**
 ```bash
 # Create a new spec with interactive prompts
-ralph new user-dashboard
+wiggum new user-dashboard
 
 # Create and open in VS Code
-ralph new user-dashboard --edit
+wiggum new user-dashboard --edit
 
 # Create with vim, skip confirmations
-ralph new user-dashboard --edit --editor vim --yes
+wiggum new user-dashboard --edit --editor vim --yes
 
 # Overwrite existing spec
-ralph new user-dashboard --force
+wiggum new user-dashboard --force
 ```
 
 ## Generated Files Structure
 
-After running `ralph init`, the following structure is created:
+After running `wiggum init`, the following structure is created:
 
 ```
 .ralph/
@@ -189,7 +195,7 @@ After running `ralph init`, the following structure is created:
 
 ## Detection Capabilities
 
-Ralph automatically detects and configures support for:
+Wiggum automatically detects and configures support for:
 
 ### Core
 - **Frameworks:** Next.js (App/Pages Router), React, Vue, Nuxt, Svelte, SvelteKit, Remix, Astro
@@ -224,27 +230,33 @@ Ralph automatically detects and configures support for:
 
 ## AI Enhancement
 
-Ralph supports AI-enhanced analysis for deeper project insights:
+Wiggum uses a multi-agent AI system for deep project analysis:
 
 ```bash
-ralph init --ai --provider anthropic
+wiggum init --provider anthropic
 ```
 
 ### Supported Providers
 
-| Provider | Environment Variable | Description |
-|----------|---------------------|-------------|
-| Anthropic | `ANTHROPIC_API_KEY` | Claude models (recommended) |
-| OpenAI | `OPENAI_API_KEY` | GPT models |
-| OpenRouter | `OPENROUTER_API_KEY` | Multiple model providers |
+| Provider | Environment Variable |
+|----------|---------------------|
+| Anthropic | `ANTHROPIC_API_KEY` |
+| OpenAI | `OPENAI_API_KEY` |
+| OpenRouter | `OPENROUTER_API_KEY` |
+
+### Optional Services
+
+| Service | Environment Variable | Description |
+|---------|---------------------|-------------|
+| Tavily | `TAVILY_API_KEY` | Web search for current best practices |
+| Context7 | `CONTEXT7_API_KEY` | Documentation lookup for your stack |
 
 ### AI Analysis Features
 
-When AI enhancement is enabled, Ralph provides:
-- **Architecture Analysis:** Understanding of project structure and patterns
-- **Code Quality Insights:** Best practices and potential improvements
-- **Dependency Review:** Security and update recommendations
-- **Custom Recommendations:** Tailored suggestions for your stack
+Wiggum's multi-agent system provides:
+- **Codebase Analyst:** Explores project structure, entry points, and patterns
+- **Stack Researcher:** Finds best practices, testing tools, and anti-patterns
+- **Orchestrator:** Merges results and recommends MCP servers
 
 ## Configuration
 
@@ -270,7 +282,6 @@ export default {
   // AI settings
   ai: {
     provider: 'anthropic',
-    enhance: false,
   },
 
   // Detected stack (auto-populated)
@@ -298,6 +309,8 @@ export default {
 | `ANTHROPIC_API_KEY` | For AI features | Anthropic API key |
 | `OPENAI_API_KEY` | For OpenAI provider | OpenAI API key |
 | `OPENROUTER_API_KEY` | For OpenRouter provider | OpenRouter API key |
+| `TAVILY_API_KEY` | Optional | Tavily API key for web search |
+| `CONTEXT7_API_KEY` | Optional | Context7 API key for doc lookup |
 | `EDITOR` | Optional | Default editor for `--edit` flag |
 | `DEBUG` | Optional | Enable debug logging |
 
@@ -309,8 +322,8 @@ Contributions are welcome! Please read our contributing guidelines before submit
 
 ```bash
 # Clone the repository
-git clone https://github.com/your-org/ralph-cli.git
-cd ralph-cli
+git clone https://github.com/federiconeri/wiggum-cli.git
+cd wiggum-cli
 
 # Install dependencies
 npm install
@@ -338,4 +351,4 @@ MIT License - see [LICENSE](LICENSE) for details.
 
 ---
 
-Built with Simpson Yellow (#FED90F) by the Ralph team.
+Built with Simpson Yellow (#FED90F) by the Wiggum team.

package/dist/ai/agents/codebase-analyst.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Codebase Analyst Agent
+ * Explores the codebase to understand its structure and patterns
+ */
+import { type LanguageModel } from 'ai';
+import type { CodebaseAnalysis, CodebaseAnalystInput } from './types.js';
+/**
+ * Run the Codebase Analyst agent
+ */
+export declare function runCodebaseAnalyst(model: LanguageModel, modelId: string, input: CodebaseAnalystInput, verbose?: boolean): Promise<CodebaseAnalysis | null>;
+//# sourceMappingURL=codebase-analyst.d.ts.map

package/dist/ai/agents/codebase-analyst.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-analyst.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/codebase-analyst.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA6B,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AA4DzE;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC,CA6BlC"}

package/dist/ai/agents/codebase-analyst.js

@@ -0,0 +1,150 @@
+/**
+ * Codebase Analyst Agent
+ * Explores the codebase to understand its structure and patterns
+ */
+import { generateText, stepCountIs } from 'ai';
+import { createExplorationTools } from '../tools.js';
+import { isReasoningModel } from '../providers.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * System prompt for the Codebase Analyst agent
+ */
+const CODEBASE_ANALYST_SYSTEM_PROMPT = `You are a Codebase Analyst agent. Your job is to thoroughly explore a codebase and produce a structured analysis.
+
+## Your Mission
+Explore the codebase to understand:
+1. Project structure and entry points
+2. Key directories and their purposes
+3. Naming conventions
+4. Available commands (from package.json)
+5. The primary project type
+
+## Exploration Strategy
+1. First, list the root directory to understand project structure
+2. Read package.json to understand scripts and dependencies
+3. Search for key patterns: entry points, routes, components
+4. Identify the PROJECT TYPE:
+   - MCP Server: Has @modelcontextprotocol dependencies
+   - REST API: Express/Fastify/Hono with route handlers
+   - React SPA: React with components, no server-side rendering
+   - Next.js App: Next.js with app or pages directory
+   - CLI Tool: Has bin entry in package.json
+   - Library: Published package without app entry
+
+## Tools Available
+- searchCode: Search using ripgrep patterns
+- readFile: Read file contents
+- listDirectory: List directory structure
+- getPackageInfo: Get package.json info
+
+## Output Format
+After exploration, output ONLY valid JSON with this exact structure:
+{
+  "projectContext": {
+    "entryPoints": ["src/index.ts"],
+    "keyDirectories": {"src/routes": "API routes"},
+    "namingConventions": "camelCase files, PascalCase components",
+    "projectType": "MCP Server"
+  },
+  "commands": {
+    "test": "npm test",
+    "lint": "npm run lint",
+    "build": "npm run build",
+    "dev": "npm run dev"
+  },
+  "implementationGuidelines": [
+    "Run npm test after changes",
+    "Use Zod for validation"
+  ],
+  "possibleMissedTechnologies": ["Redis"]
+}
+
+Keep each guideline to 5-10 words max. Max 7 guidelines.`;
+/**
+ * Run the Codebase Analyst agent
+ */
+export async function runCodebaseAnalyst(model, modelId, input, verbose = false) {
+    const tools = createExplorationTools(input.projectRoot);
+    const prompt = `Analyze this codebase and produce a structured analysis.
+
+Project: ${input.projectRoot}
+
+Start by exploring the directory structure and package.json, then produce your analysis as JSON.`;
+    try {
+        const result = await generateText({
+            model,
+            system: CODEBASE_ANALYST_SYSTEM_PROMPT,
+            prompt,
+            tools,
+            stopWhen: stepCountIs(12),
+            maxOutputTokens: 3000,
+            ...(isReasoningModel(modelId) ? {} : { temperature: 0.3 }),
+        });
+        // Extract JSON from response
+        const analysis = parseCodebaseAnalysis(result.text, result.steps, verbose);
+        return analysis;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.error(`Codebase Analyst error: ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return null;
+    }
+}
+/**
+ * Parse the codebase analysis from agent response
+ */
+function parseCodebaseAnalysis(text, steps, verbose) {
+    // Try to get text from the result or steps
+    let textToParse = text;
+    if (!textToParse || textToParse.trim() === '') {
+        // Look through steps for text content
+        const stepsList = steps || [];
+        for (let i = stepsList.length - 1; i >= 0; i--) {
+            const step = stepsList[i];
+            if (step.text && step.text.trim() !== '') {
+                textToParse = step.text;
+                break;
+            }
+        }
+    }
+    if (!textToParse || textToParse.trim() === '') {
+        if (verbose) {
+            logger.warn('Codebase Analyst: No text output found');
+        }
+        return null;
+    }
+    try {
+        // Remove markdown code blocks if present
+        let jsonText = textToParse;
+        const jsonMatch = textToParse.match(/```(?:json)?\s*([\s\S]*?)```/);
+        if (jsonMatch) {
+            jsonText = jsonMatch[1];
+        }
+        // Find JSON object
+        const objectMatch = jsonText.match(/\{[\s\S]*\}/);
+        if (objectMatch) {
+            jsonText = objectMatch[0];
+        }
+        const parsed = JSON.parse(jsonText);
+        // Validate required fields
+        if (!parsed.projectContext || !parsed.commands) {
+            if (verbose) {
+                logger.warn('Codebase Analyst: Missing required fields in response');
+            }
+            return null;
+        }
+        // Ensure projectType is set
+        if (!parsed.projectContext.projectType) {
+            parsed.projectContext.projectType = 'Unknown';
+        }
+        return parsed;
+    }
+    catch (error) {
+        if (verbose) {
+            logger.warn(`Codebase Analyst: Failed to parse JSON - ${error instanceof Error ? error.message : String(error)}`);
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=codebase-analyst.js.map

package/dist/ai/agents/codebase-analyst.js.map

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

package/dist/ai/agents/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Agents Index
+ * Exports all agent types and functions
+ */
+export type { CodebaseAnalysis, StackResearch, McpRecommendations, MultiAgentAnalysis, AgentCapabilities, AgentOptions, CodebaseAnalystInput, StackResearcherInput, OrchestratorInput, } from './types.js';
+export { runCodebaseAnalyst } from './codebase-analyst.js';
+export { runStackResearcher } from './stack-researcher.js';
+export { runOrchestrator, mergeAgentResults } from './orchestrator.js';
+import type { LanguageModel } from 'ai';
+import type { ScanResult } from '../../scanner/types.js';
+import type { MultiAgentAnalysis, AgentOptions } from './types.js';
+/**
+ * Run the full multi-agent analysis pipeline
+ */
+export declare function runMultiAgentAnalysis(model: LanguageModel, modelId: string, scanResult: ScanResult, options?: AgentOptions): Promise<MultiAgentAnalysis | null>;
+//# sourceMappingURL=index.d.ts.map

package/dist/ai/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,YAAY,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,YAAY,EACZ,oBAAoB,EACpB,oBAAoB,EACpB,iBAAiB,GAClB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,IAAI,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAiB,MAAM,wBAAwB,CAAC;AACxE,OAAO,KAAK,EACV,kBAAkB,EAElB,YAAY,EACb,MAAM,YAAY,CAAC;AAMpB;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,UAAU,EACtB,OAAO,GAAE,YAAiB,GACzB,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAwFpC"}

package/dist/ai/agents/index.js

@@ -0,0 +1,85 @@
+/**
+ * Agents Index
+ * Exports all agent types and functions
+ */
+// Agents
+export { runCodebaseAnalyst } from './codebase-analyst.js';
+export { runStackResearcher } from './stack-researcher.js';
+export { runOrchestrator, mergeAgentResults } from './orchestrator.js';
+import { runCodebaseAnalyst } from './codebase-analyst.js';
+import { runStackResearcher } from './stack-researcher.js';
+import { runOrchestrator, mergeAgentResults } from './orchestrator.js';
+import { logger } from '../../utils/logger.js';
+/**
+ * Run the full multi-agent analysis pipeline
+ */
+export async function runMultiAgentAnalysis(model, modelId, scanResult, options = {}) {
+    const { tavilyApiKey, context7ApiKey, verbose = false } = options;
+    // Determine capabilities
+    const capabilities = {
+        hasTavily: !!tavilyApiKey,
+        hasContext7: !!context7ApiKey,
+    };
+    if (verbose) {
+        logger.info('Starting multi-agent analysis...');
+        logger.info(`Capabilities: Tavily=${capabilities.hasTavily}, Context7=${capabilities.hasContext7}`);
+    }
+    // Run Codebase Analyst
+    if (verbose) {
+        logger.info('Running Codebase Analyst...');
+    }
+    const codebaseAnalysis = await runCodebaseAnalyst(model, modelId, {
+        scanResult,
+        projectRoot: scanResult.projectRoot,
+    }, verbose);
+    if (!codebaseAnalysis) {
+        if (verbose) {
+            logger.warn('Codebase Analyst failed, using defaults');
+        }
+        return null;
+    }
+    // Run Stack Researcher
+    if (verbose) {
+        logger.info('Running Stack Researcher...');
+    }
+    const stackResearch = await runStackResearcher(model, modelId, {
+        stack: scanResult.stack,
+        projectType: codebaseAnalysis.projectContext.projectType,
+        capabilities,
+    }, { tavilyApiKey, context7ApiKey }, verbose);
+    if (!stackResearch) {
+        if (verbose) {
+            logger.warn('Stack Researcher failed, using defaults');
+        }
+        // Continue with defaults - stack research is optional
+    }
+    // Run Orchestrator to merge results
+    if (verbose) {
+        logger.info('Running Orchestrator...');
+    }
+    const mcpServers = await runOrchestrator(model, modelId, {
+        codebaseAnalysis,
+        stackResearch: stackResearch || getDefaultStackResearch(),
+        stack: scanResult.stack,
+    }, verbose);
+    // Merge all results
+    const finalResult = mergeAgentResults(codebaseAnalysis, stackResearch || getDefaultStackResearch(), mcpServers);
+    if (verbose) {
+        logger.info('Multi-agent analysis complete');
+    }
+    return finalResult;
+}
+/**
+ * Get default stack research when agent fails
+ */
+function getDefaultStackResearch() {
+    return {
+        bestPractices: ['Follow project conventions'],
+        antiPatterns: ['Avoid skipping tests'],
+        testingTools: ['npm test'],
+        debuggingTools: ['console.log'],
+        documentationHints: ['Check official docs'],
+        researchMode: 'knowledge-only',
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/ai/agents/index.js.map

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

package/dist/ai/agents/orchestrator.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Orchestrator Agent
+ * Coordinates the multi-agent analysis and merges results
+ */
+import { type LanguageModel } from 'ai';
+import type { CodebaseAnalysis, StackResearch, MultiAgentAnalysis, McpRecommendations, OrchestratorInput } from './types.js';
+/**
+ * Run the Orchestrator to merge results and recommend MCP servers
+ */
+export declare function runOrchestrator(model: LanguageModel, modelId: string, input: OrchestratorInput, verbose?: boolean): Promise<McpRecommendations>;
+/**
+ * Merge all agent results into a final MultiAgentAnalysis
+ */
+export declare function mergeAgentResults(codebaseAnalysis: CodebaseAnalysis, stackResearch: StackResearch, mcpServers: McpRecommendations): MultiAgentAnalysis;
+//# sourceMappingURL=orchestrator.d.ts.map

package/dist/ai/agents/orchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../../src/ai/agents/orchestrator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAgB,KAAK,aAAa,EAAE,MAAM,IAAI,CAAC;AACtD,OAAO,KAAK,EACV,gBAAgB,EAChB,aAAa,EACb,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA6CpB;;GAEG;AACH,wBAAsB,eAAe,CACnC,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,iBAAiB,EACxB,OAAO,GAAE,OAAe,GACvB,OAAO,CAAC,kBAAkB,CAAC,CAqB7B;AA0HD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,gBAAgB,EAAE,gBAAgB,EAClC,aAAa,EAAE,aAAa,EAC5B,UAAU,EAAE,kBAAkB,GAC7B,kBAAkB,CAMpB"}