specweave 0.3.13 → 0.4.1

package/dist/cli/commands/plugin.js

@@ -0,0 +1,296 @@
+/**
+ * Plugin CLI Command
+ *
+ * Provides commands for managing SpecWeave plugins:
+ * - list: List available and enabled plugins
+ * - enable: Enable a plugin
+ * - disable: Disable a plugin
+ * - info: Show detailed plugin information
+ */
+import chalk from 'chalk';
+import { PluginManager } from '../../core/plugin-manager.js';
+import { PluginDetector } from '../../core/plugin-detector.js';
+import { AdapterLoader } from '../../adapters/adapter-loader.js';
+import { fileURLToPath } from 'url';
+import { dirname } from 'path';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+/**
+ * List available and enabled plugins
+ */
+export async function listPlugins(options) {
+    try {
+        console.log(chalk.blue('\n📦 SpecWeave Plugins\n'));
+        const projectRoot = process.cwd();
+        const manager = new PluginManager(projectRoot);
+        if (options.enabled || (!options.enabled && !options.available)) {
+            // Show enabled plugins
+            const enabledPlugins = await manager.getEnabledPlugins();
+            console.log(chalk.green('✅ Enabled Plugins:'));
+            if (enabledPlugins.length === 0) {
+                console.log(chalk.gray('  (none)'));
+            }
+            else {
+                for (const pluginName of enabledPlugins) {
+                    try {
+                        const plugin = manager.getPlugin(pluginName);
+                        console.log(`  ${chalk.cyan(plugin.manifest.name)} ${chalk.gray(`v${plugin.manifest.version}`)}`);
+                        console.log(`    ${chalk.gray(plugin.manifest.description)}`);
+                        console.log(`    ${chalk.gray(`Skills: ${plugin.skills.length}, Agents: ${plugin.agents.length}, Commands: ${plugin.commands.length}`)}`);
+                    }
+                    catch (error) {
+                        console.log(`  ${chalk.cyan(pluginName)} ${chalk.red('(error loading)')}`);
+                    }
+                }
+            }
+            console.log();
+        }
+        if (options.available || (!options.enabled && !options.available)) {
+            // Show available plugins
+            const availablePlugins = await manager.getAvailablePlugins();
+            const enabledPlugins = await manager.getEnabledPlugins();
+            const disabledPlugins = availablePlugins.filter(p => !enabledPlugins.includes(p.name));
+            console.log(chalk.yellow('📚 Available Plugins:'));
+            if (disabledPlugins.length === 0) {
+                console.log(chalk.gray('  (all enabled)'));
+            }
+            else {
+                for (const plugin of disabledPlugins) {
+                    console.log(`  ${chalk.cyan(plugin.name)} ${chalk.gray(`v${plugin.version}`)}`);
+                    console.log(`    ${chalk.gray(plugin.description)}`);
+                }
+            }
+            console.log();
+        }
+        // Show auto-detection suggestions
+        const detector = new PluginDetector();
+        const detectionResults = await detector.detectFromProject(projectRoot);
+        const suggestions = detectionResults.map(r => r.pluginName);
+        const enabledPlugins = await manager.getEnabledPlugins();
+        const newSuggestions = suggestions.filter(s => !enabledPlugins.includes(s));
+        if (newSuggestions.length > 0) {
+            console.log(chalk.magenta('💡 Suggested Plugins (auto-detected):'));
+            for (const suggestion of newSuggestions) {
+                console.log(`  ${chalk.cyan(suggestion)}`);
+            }
+            console.log(chalk.gray('\nRun `specweave plugin enable <name>` to enable a plugin'));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error listing plugins:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * Enable a plugin
+ */
+export async function enablePlugin(pluginName, options) {
+    try {
+        console.log(chalk.blue(`\n🔌 Enabling plugin: ${pluginName}\n`));
+        const projectRoot = process.cwd();
+        const adapterLoader = new AdapterLoader();
+        const toolName = await adapterLoader.detectTool();
+        const adapter = adapterLoader.getAdapter(toolName);
+        if (!adapter) {
+            throw new Error(`Adapter not found for tool: ${toolName}`);
+        }
+        const manager = new PluginManager(projectRoot);
+        // Check if already enabled
+        const enabledPlugins = await manager.getEnabledPlugins();
+        if (enabledPlugins.includes(pluginName) && !options.force) {
+            console.log(chalk.yellow(`⚠️  Plugin ${pluginName} is already enabled`));
+            console.log(chalk.gray('Use --force to reinstall'));
+            return;
+        }
+        // Load and enable plugin
+        const loadOptions = {
+            force: options.force,
+            autoInstallDependencies: true
+        };
+        await manager.loadPlugin(pluginName, adapter, loadOptions);
+        console.log(chalk.green(`\n✅ Plugin ${pluginName} enabled successfully!`));
+        // Show what was installed
+        try {
+            const plugin = manager.getPlugin(pluginName);
+            console.log(chalk.gray(`\nInstalled:`));
+            if (plugin.skills.length > 0) {
+                console.log(chalk.gray(`  Skills: ${plugin.skills.map(s => s.name).join(', ')}`));
+            }
+            if (plugin.agents.length > 0) {
+                console.log(chalk.gray(`  Agents: ${plugin.agents.map(a => a.name).join(', ')}`));
+            }
+            if (plugin.commands.length > 0) {
+                console.log(chalk.gray(`  Commands: ${plugin.commands.map(c => c.name).join(', ')}`));
+            }
+        }
+        catch (error) {
+            // Plugin info not available, skip
+        }
+        console.log(chalk.gray(`\nPlugin installed to: ${adapter.name === 'claude' ? '.claude/' : 'AGENTS.md'}`));
+        if (adapter.name === 'claude') {
+            console.log(chalk.yellow('\n⚠️  Restart Claude Code to activate the new plugin'));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error enabling plugin:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * Disable a plugin
+ */
+export async function disablePlugin(pluginName, options) {
+    try {
+        console.log(chalk.blue(`\n🔌 Disabling plugin: ${pluginName}\n`));
+        const projectRoot = process.cwd();
+        const adapterLoader = new AdapterLoader();
+        const toolName = await adapterLoader.detectTool();
+        const adapter = adapterLoader.getAdapter(toolName);
+        if (!adapter) {
+            throw new Error(`Adapter not found for tool: ${toolName}`);
+        }
+        const manager = new PluginManager(projectRoot);
+        // Check if enabled
+        const enabledPlugins = await manager.getEnabledPlugins();
+        if (!enabledPlugins.includes(pluginName)) {
+            console.log(chalk.yellow(`⚠️  Plugin ${pluginName} is not currently enabled`));
+            return;
+        }
+        // Unload plugin
+        const unloadOptions = {
+            force: options.force
+        };
+        await manager.unloadPlugin(pluginName, adapter, unloadOptions);
+        console.log(chalk.green(`\n✅ Plugin ${pluginName} disabled successfully!`));
+        if (adapter.name === 'claude') {
+            console.log(chalk.yellow('\n⚠️  Restart Claude Code to deactivate the plugin'));
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error disabling plugin:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * Show detailed plugin information
+ */
+export async function pluginInfo(pluginName) {
+    try {
+        console.log(chalk.blue(`\n📋 Plugin Information: ${pluginName}\n`));
+        const projectRoot = process.cwd();
+        const manager = new PluginManager(projectRoot);
+        const { PluginLoader } = await import('../../core/plugin-loader.js');
+        // Check if plugin exists
+        const availablePlugins = await manager.getAvailablePlugins();
+        const basicInfo = availablePlugins.find(p => p.name === pluginName);
+        if (!basicInfo) {
+            console.log(chalk.red(`❌ Plugin ${pluginName} not found`));
+            console.log(chalk.gray('\nRun `specweave plugin list --available` to see available plugins'));
+            return;
+        }
+        // Load full plugin to get manifest details
+        const loader = new PluginLoader();
+        const plugin = await loader.loadFromDirectory(basicInfo.path);
+        const manifest = plugin.manifest;
+        // Basic info
+        console.log(chalk.cyan('Name:'), manifest.name);
+        console.log(chalk.cyan('Version:'), manifest.version);
+        console.log(chalk.cyan('Description:'), manifest.description);
+        if (manifest.author) {
+            console.log(chalk.cyan('Author:'), manifest.author);
+        }
+        if (manifest.license) {
+            console.log(chalk.cyan('License:'), manifest.license);
+        }
+        console.log(chalk.cyan('SpecWeave Core Version:'), manifest.specweave_core_version);
+        // Status
+        const enabledPlugins = await manager.getEnabledPlugins();
+        const isEnabled = enabledPlugins.includes(pluginName);
+        console.log(chalk.cyan('Status:'), isEnabled ? chalk.green('✅ Enabled') : chalk.gray('⚪ Disabled'));
+        // Provides
+        console.log(chalk.cyan('\nProvides:'));
+        console.log(`  Skills: ${manifest.provides.skills.length > 0 ? manifest.provides.skills.join(', ') : chalk.gray('(none)')}`);
+        console.log(`  Agents: ${manifest.provides.agents.length > 0 ? manifest.provides.agents.join(', ') : chalk.gray('(none)')}`);
+        console.log(`  Commands: ${manifest.provides.commands.length > 0 ? manifest.provides.commands.join(', ') : chalk.gray('(none)')}`);
+        // Dependencies
+        if (manifest.dependencies?.plugins && manifest.dependencies.plugins.length > 0) {
+            console.log(chalk.cyan('\nDependencies:'));
+            for (const dep of manifest.dependencies.plugins) {
+                console.log(`  - ${dep}`);
+            }
+        }
+        // Auto-detection
+        if (manifest.auto_detect) {
+            console.log(chalk.cyan('\nAuto-Detection Triggers:'));
+            if (manifest.auto_detect.files) {
+                console.log(`  Files: ${manifest.auto_detect.files.join(', ')}`);
+            }
+            if (manifest.auto_detect.packages) {
+                console.log(`  Packages: ${manifest.auto_detect.packages.join(', ')}`);
+            }
+            if (manifest.auto_detect.env_vars) {
+                console.log(`  Environment Variables: ${manifest.auto_detect.env_vars.join(', ')}`);
+            }
+            if (manifest.auto_detect.git_remote_pattern) {
+                console.log(`  Git Remote Pattern: ${manifest.auto_detect.git_remote_pattern}`);
+            }
+        }
+        // Credits
+        if (manifest.credits) {
+            console.log(chalk.cyan('\nCredits:'));
+            if (manifest.credits.based_on) {
+                console.log(`  Based on: ${manifest.credits.based_on}`);
+            }
+            if (manifest.credits.original_author) {
+                console.log(`  Original Author: ${manifest.credits.original_author}`);
+            }
+            if (manifest.credits.contributors && manifest.credits.contributors.length > 0) {
+                console.log(`  Contributors: ${manifest.credits.contributors.join(', ')}`);
+            }
+        }
+        console.log();
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Error getting plugin info:'), error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * Main plugin command handler
+ */
+export async function pluginCommand(action, pluginName, options) {
+    switch (action) {
+        case 'list':
+            await listPlugins(options || {});
+            break;
+        case 'enable':
+            if (!pluginName) {
+                console.error(chalk.red('❌ Plugin name required for enable command'));
+                console.log(chalk.gray('Usage: specweave plugin enable <plugin-name>'));
+                process.exit(1);
+            }
+            await enablePlugin(pluginName, options || {});
+            break;
+        case 'disable':
+            if (!pluginName) {
+                console.error(chalk.red('❌ Plugin name required for disable command'));
+                console.log(chalk.gray('Usage: specweave plugin disable <plugin-name>'));
+                process.exit(1);
+            }
+            await disablePlugin(pluginName, options || {});
+            break;
+        case 'info':
+            if (!pluginName) {
+                console.error(chalk.red('❌ Plugin name required for info command'));
+                console.log(chalk.gray('Usage: specweave plugin info <plugin-name>'));
+                process.exit(1);
+            }
+            await pluginInfo(pluginName);
+            break;
+        default:
+            console.error(chalk.red(`❌ Unknown plugin action: ${action}`));
+            console.log(chalk.gray('Valid actions: list, enable, disable, info'));
+            process.exit(1);
+    }
+}
+//# sourceMappingURL=plugin.js.map

package/dist/cli/commands/plugin.js.map

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

package/dist/core/agent-model-manager.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Agent Model Manager
+ *
+ * Loads and manages agent model preferences from AGENT.md frontmatter.
+ * Each agent declares:
+ * - model_preference: sonnet | haiku | opus | auto
+ * - cost_profile: planning | execution | hybrid
+ * - fallback_behavior: strict | flexible | auto
+ *
+ * Planning agents (PM, Architect, Security) prefer Sonnet.
+ * Execution agents (Frontend, Backend, DevOps) prefer Haiku.
+ * Hybrid agents (Diagrams, Docs) use auto (context-dependent).
+ */
+import type { AgentModelPreference, Model, CostProfile, FallbackBehavior } from '../types/model-selection';
+export declare class AgentModelManager {
+    private preferences;
+    private agentsPath;
+    constructor(agentsPath?: string);
+    /**
+     * Load all agent preferences from src/agents/
+     */
+    loadAllPreferences(): Promise<void>;
+    /**
+     * Load preference for a specific agent
+     */
+    loadAgentPreference(agentName: string): Promise<AgentModelPreference | null>;
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    private extractFrontmatter;
+    /**
+     * Get preferred model for an agent (returns 'auto' if not found)
+     */
+    getPreferredModel(agentName: string): Model;
+    /**
+     * Get cost profile for an agent (returns 'hybrid' if not found)
+     */
+    getCostProfile(agentName: string): CostProfile;
+    /**
+     * Get fallback behavior for an agent
+     */
+    getFallbackBehavior(agentName: string): FallbackBehavior;
+    /**
+     * Get all loaded preferences (for debugging/reporting)
+     */
+    getAllPreferences(): Map<string, AgentModelPreference>;
+    /**
+     * Check if an agent has explicit preference (not 'auto')
+     */
+    hasExplicitPreference(agentName: string): boolean;
+}
+//# sourceMappingURL=agent-model-manager.d.ts.map

package/dist/core/agent-model-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-model-manager.d.ts","sourceRoot":"","sources":["../../src/core/agent-model-manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,oBAAoB,EAAE,KAAK,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAE3G,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,WAAW,CAAgD;IACnE,OAAO,CAAC,UAAU,CAAS;gBAEf,UAAU,CAAC,EAAE,MAAM;IAK/B;;OAEG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAoBzC;;OAEG;IACG,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC;IA2BlF;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK;IAK3C;;OAEG;IACH,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW;IAK9C;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,gBAAgB;IAKxD;;OAEG;IACH,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,oBAAoB,CAAC;IAItD;;OAEG;IACH,qBAAqB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;CAIlD"}

package/dist/core/agent-model-manager.js

@@ -0,0 +1,120 @@
+/**
+ * Agent Model Manager
+ *
+ * Loads and manages agent model preferences from AGENT.md frontmatter.
+ * Each agent declares:
+ * - model_preference: sonnet | haiku | opus | auto
+ * - cost_profile: planning | execution | hybrid
+ * - fallback_behavior: strict | flexible | auto
+ *
+ * Planning agents (PM, Architect, Security) prefer Sonnet.
+ * Execution agents (Frontend, Backend, DevOps) prefer Haiku.
+ * Hybrid agents (Diagrams, Docs) use auto (context-dependent).
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import yaml from 'js-yaml';
+export class AgentModelManager {
+    constructor(agentsPath) {
+        this.preferences = new Map();
+        // Default to src/agents (works in development and after build)
+        this.agentsPath = agentsPath || path.join(__dirname, '../agents');
+    }
+    /**
+     * Load all agent preferences from src/agents/
+     */
+    async loadAllPreferences() {
+        try {
+            const agentDirs = await fs.readdir(this.agentsPath);
+            for (const agentDir of agentDirs) {
+                const agentMdPath = path.join(this.agentsPath, agentDir, 'AGENT.md');
+                if (await fs.pathExists(agentMdPath)) {
+                    const preference = await this.loadAgentPreference(agentDir);
+                    if (preference) {
+                        this.preferences.set(agentDir, preference);
+                    }
+                }
+            }
+        }
+        catch (error) {
+            console.warn('Failed to load agent preferences:', error);
+            // Continue with empty preferences (fallback to defaults)
+        }
+    }
+    /**
+     * Load preference for a specific agent
+     */
+    async loadAgentPreference(agentName) {
+        const agentMdPath = path.join(this.agentsPath, agentName, 'AGENT.md');
+        if (!await fs.pathExists(agentMdPath)) {
+            return null;
+        }
+        try {
+            const content = await fs.readFile(agentMdPath, 'utf-8');
+            const frontmatter = this.extractFrontmatter(content);
+            if (!frontmatter) {
+                return null;
+            }
+            return {
+                agent: agentName,
+                preference: frontmatter.model_preference || 'auto',
+                profile: frontmatter.cost_profile || 'hybrid',
+                fallback: frontmatter.fallback_behavior || 'auto',
+            };
+        }
+        catch (error) {
+            console.warn(`Failed to load preference for agent ${agentName}:`, error);
+            return null;
+        }
+    }
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    extractFrontmatter(content) {
+        const match = content.match(/^---\n([\s\S]*?)\n---/);
+        if (!match)
+            return null;
+        try {
+            return yaml.load(match[1]);
+        }
+        catch (error) {
+            console.error('Failed to parse YAML frontmatter:', error);
+            return null;
+        }
+    }
+    /**
+     * Get preferred model for an agent (returns 'auto' if not found)
+     */
+    getPreferredModel(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.preference || 'auto';
+    }
+    /**
+     * Get cost profile for an agent (returns 'hybrid' if not found)
+     */
+    getCostProfile(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.profile || 'hybrid';
+    }
+    /**
+     * Get fallback behavior for an agent
+     */
+    getFallbackBehavior(agentName) {
+        const preference = this.preferences.get(agentName);
+        return preference?.fallback || 'auto';
+    }
+    /**
+     * Get all loaded preferences (for debugging/reporting)
+     */
+    getAllPreferences() {
+        return new Map(this.preferences);
+    }
+    /**
+     * Check if an agent has explicit preference (not 'auto')
+     */
+    hasExplicitPreference(agentName) {
+        const pref = this.getPreferredModel(agentName);
+        return pref !== 'auto';
+    }
+}
+//# sourceMappingURL=agent-model-manager.js.map

package/dist/core/agent-model-manager.js.map

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

package/dist/core/cost-tracker.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Cost Tracker Service
+ *
+ * Real-time cost tracking for agent executions. Tracks token usage, calculates
+ * costs, aggregates by increment, and calculates savings vs baseline (Sonnet-only).
+ *
+ * Persistence: Stores data in .specweave/logs/costs.json
+ */
+import type { Model } from '../types/model-selection';
+import type { CostSession, IncrementCostReport } from '../types/cost-tracking';
+interface CostTrackerConfig {
+    logPath?: string;
+    autoSave?: boolean;
+}
+export declare class CostTracker {
+    private sessions;
+    private currentSessionId;
+    private logPath;
+    private autoSave;
+    constructor(config?: CostTrackerConfig);
+    /**
+     * Start a new tracking session
+     *
+     * @param agent - Agent name (e.g., 'pm', 'frontend')
+     * @param model - Model used ('sonnet', 'haiku', 'opus')
+     * @param increment - Optional increment ID (e.g., '0003')
+     * @param command - Optional command that triggered this (e.g., '/specweave.inc')
+     * @returns Session ID
+     */
+    startSession(agent: string, model: Exclude<Model, 'auto'>, increment?: string, command?: string): string;
+    /**
+     * Record token usage for current session
+     *
+     * @param inputTokens - Number of input tokens
+     * @param outputTokens - Number of output tokens
+     * @param sessionId - Optional session ID (defaults to current)
+     */
+    recordTokens(inputTokens: number, outputTokens: number, sessionId?: string): void;
+    /**
+     * End current session
+     *
+     * @param sessionId - Optional session ID (defaults to current)
+     */
+    endSession(sessionId?: string): void;
+    /**
+     * Get session by ID
+     */
+    getSession(sessionId: string): CostSession | undefined;
+    /**
+     * Get current session
+     */
+    getCurrentSession(): CostSession | undefined;
+    /**
+     * Get all sessions for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Array of sessions for this increment
+     */
+    getIncrementSessions(incrementId: string): CostSession[];
+    /**
+     * Get cost report for a specific increment
+     *
+     * @param incrementId - Increment ID (e.g., '0003')
+     * @returns Aggregate cost report
+     */
+    getIncrementCost(incrementId: string): IncrementCostReport;
+    /**
+     * Get total cost across all sessions
+     */
+    getTotalCost(): number;
+    /**
+     * Get total savings across all sessions
+     */
+    getTotalSavings(): number;
+    /**
+     * Get all sessions
+     */
+    getAllSessions(): CostSession[];
+    /**
+     * Clear all sessions (useful for testing)
+     */
+    clearSessions(): void;
+    /**
+     * Save sessions to disk
+     */
+    saveToDisk(): Promise<void>;
+    /**
+     * Load sessions from disk
+     */
+    loadFromDisk(): Promise<void>;
+    /**
+     * Generate unique session ID
+     */
+    private generateSessionId;
+    /**
+     * Get summary statistics
+     */
+    getSummary(): {
+        totalSessions: number;
+        totalCost: number;
+        totalSavings: number;
+        savingsPercentage: number;
+        mostExpensiveAgent: string | null;
+        cheapestAgent: string | null;
+    };
+}
+export {};
+//# sourceMappingURL=cost-tracker.d.ts.map

package/dist/core/cost-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cost-tracker.d.ts","sourceRoot":"","sources":["../../src/core/cost-tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAc,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG3F,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAID,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAuC;IACvD,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAU;gBAEd,MAAM,GAAE,iBAAsB;IAK1C;;;;;;;;OAQG;IACH,YAAY,CACV,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,EAC7B,SAAS,CAAC,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM;IAwBT;;;;;;OAMG;IACH,YAAY,CACV,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,SAAS,CAAC,EAAE,MAAM,GACjB,IAAI;IA+BP;;;;OAIG;IACH,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI;IAuBpC;;OAEG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD;;OAEG;IACH,iBAAiB,IAAI,WAAW,GAAG,SAAS;IAM5C;;;;;OAKG;IACH,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,WAAW,EAAE;IAMxD;;;;;OAKG;IACH,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB;IA+C1D;;OAEG;IACH,YAAY,IAAI,MAAM;IAOtB;;OAEG;IACH,eAAe,IAAI,MAAM;IAOzB;;OAEG;IACH,cAAc,IAAI,WAAW,EAAE;IAI/B;;OAEG;IACH,aAAa,IAAI,IAAI;IAKrB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAkBjC;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;IAwBnC;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,UAAU,IAAI;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;QAClC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B;CAwCF"}