decibel-tools-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Decibel Systems
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,335 @@
+# decibel-tools-mcp
+
+MCP (Model Context Protocol) server exposing Decibel tools (Designer, Architect, Sentinel, Oracle, Learnings) over stdio. Connect from Cursor, Claude, ChatGPT, and other MCP-compatible clients.
+
+<a href="cursor://anysphere.cursor-deeplink/mcp/install?name=decibel-tools&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRlY2liZWwtdG9vbHMtbWNwIl19">
+  <img src="https://cursor.com/deeplink/mcp-install-dark.svg" alt="Add Decibel Tools to Cursor" height="32" />
+</a>
+
+## Features
+
+- **Designer** - Record design decisions with project tracking
+- **Architect** - Create Architecture Decision Records (ADRs)
+- **Sentinel** - Track issues and epics with severity levels
+- **Oracle** - Get AI-powered next action recommendations
+- **Learnings** - Maintain living technical learnings documents
+
+## Quick Start
+
+### Installation
+
+```bash
+npm install
+```
+
+### Development
+
+Run the server in development mode:
+
+```bash
+npm run dev
+```
+
+### Production Build
+
+```bash
+npm run build
+npm start
+```
+
+### Testing
+
+Run the test script to verify all tools work:
+
+```bash
+npm test
+```
+
+## Configuration
+
+The server uses environment variables for configuration:
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `DECIBEL_ENV` | `dev` | Environment (dev, staging, prod) |
+| `DECIBEL_ORG` | `mediareason` | Organization name |
+| `DECIBEL_MCP_ROOT` | `~/.decibel` | Root directory for global data storage |
+
+Data is stored in project-local `.decibel/` folders when available, falling back to the global root for cross-project data.
+
+Copy `.env.example` to `.env` and configure as needed:
+
+```bash
+cp .env.example .env
+```
+
+## Connecting to Clients
+
+### Cursor
+
+**One-click install:** Click the button at the top of this README, or use the deep link:
+```
+cursor://anysphere.cursor-deeplink/mcp/install?name=decibel-tools&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsImRlY2liZWwtdG9vbHMtbWNwIl19
+```
+
+**Manual setup:** Add to `~/.cursor/mcp.json` (global) or `.cursor/mcp.json` (project-local):
+
+```json
+{
+  "mcpServers": {
+    "decibel-tools": {
+      "command": "npx",
+      "args": ["-y", "decibel-tools-mcp"]
+    }
+  }
+}
+```
+
+See [Cursor platform docs](docs/platforms/cursor.md) for troubleshooting and advanced setup.
+
+### Claude Desktop
+
+Add to your Claude configuration (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS):
+
+```json
+{
+  "mcpServers": {
+    "decibel-tools": {
+      "command": "node",
+      "args": ["/path/to/decibel-tools-mcp/dist/server.js"]
+    }
+  }
+}
+```
+
+The server will automatically discover `.decibel/` folders in your projects. No `DECIBEL_MCP_ROOT` environment variable is needed for typical use.
+
+## Tools Reference
+
+### designer_record_design_decision
+
+Record a design decision for a project.
+
+**Input:**
+- `project_id` (required): Project identifier
+- `area` (required): Design area (e.g., "UI", "API", "Database")
+- `summary` (required): Brief summary of the decision
+- `details` (optional): Detailed explanation
+
+**Output:**
+- `id`: Filename of the created record
+- `timestamp`: ISO timestamp
+- `path`: Full path to the file
+
+**File Location:** `{ROOT_DIR}/designer/{project_id}/YYYY-MM-DDTHH-mm-ssZ-{slug}.md`
+
+---
+
+### architect_record_arch_decision
+
+Record an Architecture Decision Record (ADR).
+
+**Input:**
+- `system_id` (required): System identifier
+- `change` (required): Description of the architectural change
+- `rationale` (required): Reasoning behind the decision
+- `impact` (optional): Expected impact description
+
+**Output:**
+- `id`: Filename of the created ADR
+- `timestamp`: ISO timestamp
+- `path`: Full path to the file
+
+**File Location:** `{ROOT_DIR}/architect/{system_id}/YYYY-MM-DDTHH-mm-ssZ-{slug}.md`
+
+---
+
+### sentinel_create_issue
+
+Create a tracked issue for a repository.
+
+**Input:**
+- `repo` (required): Repository name
+- `severity` (required): One of `low`, `med`, `high`, `critical`
+- `title` (required): Issue title
+- `details` (required): Detailed description
+- `epic_id` (optional): Parent epic ID (e.g., "EPIC-0001")
+
+**Output:**
+- `id`: Filename of the created issue
+- `timestamp`: ISO timestamp
+- `path`: Full path to the file
+- `status`: Issue status (always "open" for new issues)
+
+**File Location:** `{ROOT_DIR}/sentinel/{repo}/issues/YYYY-MM-DDTHH-mm-ssZ-{slug}.md`
+
+---
+
+### sentinel_log_epic
+
+Create a new epic (large feature) record.
+
+**Input:**
+- `title` (required): Epic title
+- `summary` (required): Brief summary
+- `motivation` (optional): Array of motivation statements
+- `outcomes` (optional): Array of desired outcomes
+- `acceptance_criteria` (optional): Array of acceptance criteria
+- `priority` (optional): One of `low`, `medium`, `high`, `critical`
+- `tags` (optional): Array of tags
+- `owner` (optional): Epic owner
+- `squad` (optional): Team responsible
+
+**Output:**
+- `epic_id`: Generated epic ID (e.g., "EPIC-0001")
+- `timestamp`: ISO timestamp
+- `path`: Full path to the file
+
+---
+
+### sentinel_list_epics
+
+List all epics with optional filters.
+
+**Input:**
+- `status` (optional): Filter by status (`planned`, `in_progress`, `shipped`, `on_hold`, `cancelled`)
+- `priority` (optional): Filter by priority
+- `tags` (optional): Filter by tags (matches any)
+
+---
+
+### sentinel_get_epic
+
+Get details of a specific epic.
+
+**Input:**
+- `epic_id` (required): Epic ID (e.g., "EPIC-0001")
+
+---
+
+### sentinel_get_epic_issues
+
+Get all issues linked to an epic.
+
+**Input:**
+- `epic_id` (required): Epic ID
+
+---
+
+### sentinel_resolve_epic
+
+Fuzzy search for epics by name or keyword.
+
+**Input:**
+- `query` (required): Search query
+- `limit` (optional): Maximum matches to return (default: 5)
+
+---
+
+### oracle_next_actions
+
+Get recommended next actions based on recent project activity.
+
+**Input:**
+- `project_id` (required): Project to analyze
+- `focus` (optional): Filter by area (e.g., "architect", "sentinel", or keyword)
+
+**Output:**
+- `actions`: Array of recommended actions
+  - `description`: What to do
+  - `source`: File path reference
+  - `priority`: One of `low`, `med`, `high`
+
+---
+
+### learnings_append
+
+Append a new entry to a project's technical learnings document. Creates a living document that accumulates lessons learned, gotchas, and insights over time.
+
+**Input:**
+- `project_id` (required): Project identifier
+- `category` (required): One of `debug`, `integration`, `architecture`, `tooling`, `process`, `other`
+- `title` (required): Brief title for the learning
+- `content` (required): The learning content - what happened, what was learned
+- `tags` (optional): Array of tags for searchability
+
+**Output:**
+- `timestamp`: ISO timestamp
+- `path`: Full path to the file
+- `entry_count`: Total number of entries in the document
+
+**File Location:** `{ROOT_DIR}/learnings/{project_id}.md`
+
+---
+
+### learnings_list
+
+List entries from a project's technical learnings document.
+
+**Input:**
+- `project_id` (required): Project identifier
+- `category` (optional): Filter by category
+- `limit` (optional): Maximum entries to return (most recent first)
+
+**Output:**
+- `path`: Path to the learnings file
+- `entries`: Array of learning entries
+- `total_count`: Total number of entries
+
+---
+
+## Data Storage
+
+Data is stored in project-local `.decibel/` folders as YAML files:
+
+```
+{project_root}/
+└── .decibel/
+    ├── sentinel/
+    │   ├── issues/
+    │   │   └── ISS-{nnnn}.yml
+    │   └── epics/
+    │       └── EPIC-{nnnn}.yml
+    ├── architect/
+    │   └── adrs/
+    │       └── ADR-{nnnn}.yml
+    ├── designer/
+    │   └── YYYY-MM-DDTHH-mm-ssZ-{slug}.md
+    └── learnings/
+        └── {project_id}.md
+```
+
+Global data (friction logs, cross-project learnings) is stored in `~/.decibel/` or the path specified by `DECIBEL_MCP_ROOT`.
+
+## Development
+
+### Project Structure
+
+```
+src/
+├── server.ts      # MCP server entrypoint
+├── config.ts      # Environment configuration
+├── test.ts        # Test script
+└── tools/
+    ├── designer.ts   # Design decision recording
+    ├── architect.ts  # Architecture decision recording
+    ├── sentinel.ts   # Issue and epic tracking
+    ├── oracle.ts     # Next actions inference
+    └── learnings.ts  # Living learnings documents
+```
+
+### Building
+
+```bash
+npm run build   # Compile TypeScript to dist/
+```
+
+### Running in Development
+
+```bash
+npm run dev     # Run with tsx (no build required)
+```
+
+## License
+
+MIT

package/dist/agentic/compiler.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Agentic Pack Compiler
+ *
+ * Compiles agentic configuration files into a versioned, hashed pack.
+ * Reads from .decibel/architect/agentic/ and outputs compiled_agentic_pack.json
+ */
+import { ResolvedProjectPaths } from '../projectRegistry.js';
+import { CompileResult, CompilePackInput, CompilePackOutput } from './types.js';
+/**
+ * Compile agentic pack from project configuration
+ */
+export declare function compilePack(input: CompilePackInput): Promise<CompilePackOutput>;
+/**
+ * Load a previously compiled pack
+ */
+export declare function loadCompiledPack(resolved: ResolvedProjectPaths): Promise<CompileResult | null>;
+/**
+ * Get or compile pack (compile if not exists or outdated)
+ */
+export declare function getOrCompilePack(resolved: ResolvedProjectPaths): Promise<CompileResult>;
+//# sourceMappingURL=compiler.d.ts.map

package/dist/agentic/compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compiler.d.ts","sourceRoot":"","sources":["../../src/agentic/compiler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH,OAAO,EAAuB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAElF,OAAO,EAEL,aAAa,EAKb,gBAAgB,EAChB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA0MpB;;GAEG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA2CrF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQpG;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,aAAa,CAAC,CAcxB"}

package/dist/agentic/compiler.js

@@ -0,0 +1,267 @@
+/**
+ * Agentic Pack Compiler
+ *
+ * Compiles agentic configuration files into a versioned, hashed pack.
+ * Reads from .decibel/architect/agentic/ and outputs compiled_agentic_pack.json
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import crypto from 'crypto';
+import yaml from 'yaml';
+import { log } from '../config.js';
+import { resolveProjectPaths } from '../projectRegistry.js';
+import { ensureDir } from '../dataRoot.js';
+// ============================================================================
+// Default Configurations
+// ============================================================================
+const DEFAULT_TAXONOMY = {
+    roles: {
+        Sensor: { emoji: '👁️', description: 'Data collection and observation' },
+        Analyst: { emoji: '🧠', description: 'Pattern recognition and analysis' },
+        Overmind: { emoji: '🎯', description: 'Decision making and coordination' },
+        Specialist: { emoji: '🔧', description: 'Domain-specific expertise' },
+    },
+    statuses: {
+        OK: { emoji: '✓', color: 'green' },
+        DEGRADED: { emoji: '⚠️', color: 'yellow' },
+        BLOCKED: { emoji: '🛑', color: 'red' },
+        ALERT: { emoji: '🚨', color: 'magenta' },
+    },
+    loads: {
+        GREEN: { emoji: '🟢', color: 'green' },
+        YELLOW: { emoji: '🟡', color: 'yellow' },
+        RED: { emoji: '🔴', color: 'red' },
+    },
+};
+const DEFAULT_RENDERER = {
+    id: 'default',
+    name: 'Default Renderer',
+    description: 'Basic text output with minimal formatting',
+    template: `{{role_emoji}} {{role}} | {{status}} | Load: {{load}}
+
+{{summary}}
+
+{{#evidence}}
+Evidence:
+{{#items}}
+- {{source}}: {{value}}
+{{/items}}
+{{/evidence}}
+
+{{#missing_data}}
+Missing Data:
+{{#items}}
+- {{field}}: {{reason}}
+{{/items}}
+{{/missing_data}}
+
+{{#decision}}
+Decision: {{decision}}
+{{/decision}}`,
+    constraints: {
+        max_emoji_count: 5,
+        emoji_position: 'header-only',
+        max_lines: 50,
+        banned_words: ['amazing', 'incredible', 'revolutionary', 'game-changing'],
+        banned_punctuation: ['!'],
+    },
+};
+const DEFAULT_CONSENSUS = {
+    quorum_threshold: 0.67,
+    dissent_highlight_threshold: 0.3,
+    max_pending_decisions: 10,
+};
+// ============================================================================
+// YAML Loading Helpers
+// ============================================================================
+async function loadYamlFile(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return yaml.parse(content);
+    }
+    catch (error) {
+        if (error.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+async function loadYamlDir(dirPath) {
+    const result = {};
+    try {
+        const files = await fs.readdir(dirPath);
+        for (const file of files) {
+            if (file.endsWith('.yaml') || file.endsWith('.yml')) {
+                const filePath = path.join(dirPath, file);
+                const content = await loadYamlFile(filePath);
+                if (content) {
+                    const id = path.basename(file, path.extname(file));
+                    result[id] = content;
+                }
+            }
+        }
+    }
+    catch (error) {
+        if (error.code !== 'ENOENT') {
+            throw error;
+        }
+    }
+    return result;
+}
+// ============================================================================
+// Pack Compiler
+// ============================================================================
+async function loadPackConfigs(agenticDir) {
+    const sourceFiles = [];
+    // Load taxonomy
+    const taxonomyPath = path.join(agenticDir, 'taxonomy.yaml');
+    const taxonomy = (await loadYamlFile(taxonomyPath)) || DEFAULT_TAXONOMY;
+    if (await fileExists(taxonomyPath))
+        sourceFiles.push(taxonomyPath);
+    // Load renderers
+    const renderersPath = path.join(agenticDir, 'renderers.yaml');
+    let renderers = { default: DEFAULT_RENDERER };
+    const loadedRenderers = await loadYamlFile(renderersPath);
+    if (loadedRenderers) {
+        renderers = { ...renderers, ...loadedRenderers };
+        sourceFiles.push(renderersPath);
+    }
+    // Also load from renderers/ directory
+    const renderersDir = path.join(agenticDir, 'renderers');
+    const dirRenderers = await loadYamlDir(renderersDir);
+    for (const [id, config] of Object.entries(dirRenderers)) {
+        renderers[id] = { ...config, id };
+        sourceFiles.push(path.join(renderersDir, `${id}.yaml`));
+    }
+    // Load consensus
+    const consensusPath = path.join(agenticDir, 'consensus.yaml');
+    const consensus = (await loadYamlFile(consensusPath)) || DEFAULT_CONSENSUS;
+    if (await fileExists(consensusPath))
+        sourceFiles.push(consensusPath);
+    // Load ANSI styles
+    const ansiStylesPath = path.join(agenticDir, 'ansi_styles.yaml');
+    const ansiStyles = await loadYamlFile(ansiStylesPath);
+    if (await fileExists(ansiStylesPath))
+        sourceFiles.push(ansiStylesPath);
+    // Load avatars
+    const avatarsDir = path.join(agenticDir, 'avatars');
+    const avatars = await loadYamlDir(avatarsDir);
+    for (const file of Object.keys(avatars)) {
+        sourceFiles.push(path.join(avatarsDir, `${file}.yaml`));
+    }
+    // Load pack overrides
+    const packsDir = path.join(agenticDir, 'packs');
+    const packs = await loadYamlDir(packsDir);
+    for (const [packId, packConfig] of Object.entries(packs)) {
+        // Merge pack-specific overrides
+        if (packConfig.renderers) {
+            renderers = { ...renderers, ...packConfig.renderers };
+        }
+        if (packConfig.avatars) {
+            Object.assign(avatars, packConfig.avatars);
+        }
+        sourceFiles.push(path.join(packsDir, `${packId}.yaml`));
+    }
+    return {
+        pack: {
+            taxonomy,
+            renderers,
+            consensus,
+            avatars,
+            ansi_styles: ansiStyles || undefined,
+        },
+        sourceFiles,
+    };
+}
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function computePackHash(pack) {
+    const content = JSON.stringify(pack, Object.keys(pack).sort());
+    return crypto.createHash('sha256').update(content).digest('hex').substring(0, 12);
+}
+function generatePackId() {
+    const timestamp = new Date().toISOString().replace(/[-:]/g, '').split('.')[0];
+    const random = Math.random().toString(36).substring(2, 6);
+    return `pack-${timestamp}-${random}`;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * Compile agentic pack from project configuration
+ */
+export async function compilePack(input) {
+    try {
+        const resolved = resolveProjectPaths(input.projectId);
+        const agenticDir = resolved.subPath('architect', 'agentic');
+        log(`agentic-compiler: Compiling pack from ${agenticDir}`);
+        // Load all configs
+        const { pack, sourceFiles } = await loadPackConfigs(agenticDir);
+        // Generate pack ID and hash
+        const packId = generatePackId();
+        const packHash = computePackHash(pack);
+        const result = {
+            pack_id: packId,
+            pack_hash: packHash,
+            compiled_at: new Date().toISOString(),
+            content: pack,
+            source_files: sourceFiles,
+        };
+        // Write compiled pack to output
+        const outputDir = resolved.subPath('architect', 'agentic', 'compiled');
+        ensureDir(outputDir);
+        const outputPath = path.join(outputDir, 'compiled_agentic_pack.json');
+        await fs.writeFile(outputPath, JSON.stringify(result, null, 2), 'utf-8');
+        log(`agentic-compiler: Pack compiled successfully (${packHash})`);
+        log(`agentic-compiler: Output written to ${outputPath}`);
+        return {
+            status: 'compiled',
+            result,
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        log(`agentic-compiler: Error compiling pack: ${message}`);
+        return {
+            status: 'error',
+            error: message,
+        };
+    }
+}
+/**
+ * Load a previously compiled pack
+ */
+export async function loadCompiledPack(resolved) {
+    const outputPath = resolved.subPath('architect', 'agentic', 'compiled', 'compiled_agentic_pack.json');
+    try {
+        const content = await fs.readFile(outputPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Get or compile pack (compile if not exists or outdated)
+ */
+export async function getOrCompilePack(resolved) {
+    // Try to load existing
+    const existing = await loadCompiledPack(resolved);
+    if (existing) {
+        return existing;
+    }
+    // Compile new
+    const result = await compilePack({ projectId: resolved.id });
+    if (result.status === 'error' || !result.result) {
+        throw new Error(result.error || 'Failed to compile pack');
+    }
+    return result.result;
+}
+//# sourceMappingURL=compiler.js.map

package/dist/agentic/compiler.js.map

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

package/dist/agentic/golden.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Agentic Pack Golden Eval
+ *
+ * Regression testing harness for semiotic clarity.
+ * Compares rendered outputs against known-good golden files.
+ */
+import { ResolvedProjectPaths } from '../projectRegistry.js';
+import { GoldenResult, CanonicalPayload, GoldenInput, GoldenOutputResult } from './types.js';
+/**
+ * Run all golden eval cases
+ */
+export declare function runGoldenEval(resolved: ResolvedProjectPaths, caseName?: string, strict?: boolean): Promise<GoldenResult>;
+/**
+ * Update golden files with current output (for updating baselines)
+ */
+export declare function updateGoldenFile(resolved: ResolvedProjectPaths, caseName: string, rendererId: string): Promise<void>;
+/**
+ * Create a new golden case from a payload
+ */
+export declare function createGoldenCase(resolved: ResolvedProjectPaths, caseName: string, payload: CanonicalPayload, rendererIds: string[]): Promise<void>;
+/**
+ * MCP tool handler for running golden eval
+ */
+export declare function runGolden(input: GoldenInput): Promise<GoldenOutputResult>;
+//# sourceMappingURL=golden.d.ts.map

package/dist/agentic/golden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"golden.d.ts","sourceRoot":"","sources":["../../src/agentic/golden.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAAuB,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAEL,YAAY,EAEZ,gBAAgB,EAEhB,WAAW,EACX,kBAAkB,EACnB,MAAM,YAAY,CAAC;AA4KpB;;GAEG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,OAAe,GACtB,OAAO,CAAC,YAAY,CAAC,CA4CvB;AAMD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,oBAAoB,EAC9B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,gBAAgB,EACzB,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,IAAI,CAAC,CAsBf;AAMD;;GAEG;AACH,wBAAsB,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoB/E"}