@decibelsystems/tools 2.0.0

package/dist/sentinelIssues.js

@@ -0,0 +1,297 @@
+import fs from 'fs/promises';
+import path from 'path';
+import { parse as parseYaml, parseAllDocuments, stringify as stringifyYaml } from 'yaml';
+import { log } from './config.js';
+import { getWritePath, readFilesFromBothPaths } from './decibelPaths.js';
+// ============================================================================
+// Constants
+// ============================================================================
+const ISSUES_SUBPATH = 'sentinel/issues';
+// ============================================================================
+// Helpers
+// ============================================================================
+/**
+ * Slugify a title for use in filename
+ */
+function slugify(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, '-')
+        .replace(/^-|-$/g, '')
+        .substring(0, 50);
+}
+/**
+ * Extract numeric suffix from issue ID (e.g., "ISS-0007" -> 7)
+ */
+function extractIssueNumber(id) {
+    const match = id.match(/^ISS-(\d+)$/i);
+    return match ? parseInt(match[1], 10) : 0;
+}
+/**
+ * Format issue ID with zero-padding
+ */
+function formatIssueId(num) {
+    return `ISS-${num.toString().padStart(4, '0')}`;
+}
+/**
+ * Ensure directory exists
+ */
+async function ensureDir(dirPath) {
+    try {
+        await fs.mkdir(dirPath, { recursive: true });
+    }
+    catch {
+        // Directory already exists or other error
+    }
+}
+/**
+ * Safely parse YAML content that might contain multiple documents (frontmatter format).
+ * Returns the first document's contents, or throws if no valid document found.
+ */
+function safeParseYaml(content) {
+    // First, try simple parse (most common case)
+    try {
+        return parseYaml(content);
+    }
+    catch (err) {
+        // Check if error is about multiple documents
+        const message = err instanceof Error ? err.message : String(err);
+        if (!message.includes('multiple documents')) {
+            throw err;
+        }
+    }
+    // Handle multi-document YAML (frontmatter format with --- delimiters)
+    const docs = parseAllDocuments(content);
+    if (docs.length === 0) {
+        throw new Error('No YAML documents found');
+    }
+    // Return the first document (usually the frontmatter)
+    const firstDoc = docs[0].toJSON();
+    if (typeof firstDoc !== 'object' || firstDoc === null) {
+        throw new Error('First YAML document is not an object');
+    }
+    return firstDoc;
+}
+// ============================================================================
+// Public API
+// ============================================================================
+/**
+ * List all issues for a project
+ * Reads from both .decibel/ and decibel/ paths, deduping by filename
+ */
+export async function listIssuesForProject(projectId) {
+    const issues = [];
+    const seenIds = new Set();
+    // Read from both .decibel/ and decibel/ paths
+    const files = await readFilesFromBothPaths(projectId, ISSUES_SUBPATH);
+    if (files.length === 0) {
+        log(`sentinelIssues: No issues found for project: ${projectId}`);
+        return [];
+    }
+    for (const { filePath, source } of files) {
+        try {
+            const content = await fs.readFile(filePath, 'utf-8');
+            const parsed = safeParseYaml(content);
+            // Validate required fields
+            const id = parsed.id;
+            const title = parsed.title;
+            if (!id || !title) {
+                log(`sentinelIssues: Skipping ${filePath} - missing id or title`);
+                continue;
+            }
+            // Skip duplicates (primary takes precedence)
+            if (seenIds.has(id)) {
+                log(`sentinelIssues: Skipping duplicate ${id} from ${source} path`);
+                continue;
+            }
+            seenIds.add(id);
+            const issue = {
+                id,
+                title,
+                project: parsed.project || projectId,
+                status: parsed.status || 'open',
+                priority: parsed.priority,
+                epicId: parsed.epic_id || parsed.epicId,
+                tags: parsed.tags,
+                created_at: parsed.created_at,
+                updated_at: parsed.updated_at,
+                description: parsed.description,
+            };
+            // Copy any extra fields
+            for (const key of Object.keys(parsed)) {
+                if (!(key in issue)) {
+                    issue[key] = parsed[key];
+                }
+            }
+            issues.push(issue);
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            log(`sentinelIssues: Failed to parse ${filePath}: ${message}`);
+        }
+    }
+    // Sort by ID (newest first)
+    issues.sort((a, b) => extractIssueNumber(b.id) - extractIssueNumber(a.id));
+    return issues;
+}
+/**
+ * Create a new issue for a project
+ */
+export async function createIssue(input) {
+    const { projectId, title, description, epicId, priority, tags } = input;
+    // Always write to .decibel/ (primary path)
+    const issuesDir = await getWritePath(projectId, ISSUES_SUBPATH);
+    await ensureDir(issuesDir);
+    // Find next issue number
+    const existingIssues = await listIssuesForProject(projectId);
+    const maxNum = existingIssues.reduce((max, issue) => Math.max(max, extractIssueNumber(issue.id)), 0);
+    const newNum = maxNum + 1;
+    const newId = formatIssueId(newNum);
+    // Build filename
+    const slug = slugify(title);
+    const filename = `${newId}-${slug}.yml`;
+    const filePath = path.join(issuesDir, filename);
+    // Build issue object
+    const now = new Date().toISOString();
+    const issue = {
+        id: newId,
+        title,
+        project: projectId,
+        status: 'open',
+        priority: priority || 'medium',
+        tags: tags || [],
+        created_at: now,
+        updated_at: now,
+    };
+    if (epicId) {
+        issue.epicId = epicId;
+    }
+    if (description) {
+        issue.description = description;
+    }
+    // Build YAML content
+    // Use a specific field order for cleaner output
+    const yamlObj = {
+        id: issue.id,
+        title: issue.title,
+        project: issue.project,
+        status: issue.status,
+        priority: issue.priority,
+    };
+    if (epicId) {
+        yamlObj.epic_id = epicId;
+    }
+    yamlObj.tags = issue.tags;
+    yamlObj.created_at = issue.created_at;
+    yamlObj.updated_at = issue.updated_at;
+    if (description) {
+        yamlObj.description = description;
+    }
+    const yamlContent = stringifyYaml(yamlObj, {
+        lineWidth: 0, // Don't wrap lines
+    });
+    // Write file
+    await fs.writeFile(filePath, yamlContent, 'utf-8');
+    log(`sentinelIssues: Created issue at ${filePath}`);
+    return {
+        ...issue,
+        filePath,
+    };
+}
+/**
+ * Get a single issue by ID (e.g., "ISS-0005") with full content
+ */
+export async function getIssueById(projectId, issueId) {
+    const issues = await listIssuesForProject(projectId);
+    const normalizedId = issueId.toUpperCase();
+    return issues.find((i) => i.id.toUpperCase() === normalizedId) ?? null;
+}
+/**
+ * Update an existing issue — status, priority, tags, and/or append a note.
+ * Reads the YAML file, applies changes, writes back.
+ */
+export async function updateIssue(input) {
+    const { projectId, issueId, status, priority, tags, note } = input;
+    // Find the issue file
+    const files = await readFilesFromBothPaths(projectId, ISSUES_SUBPATH);
+    const normalizedId = issueId.toUpperCase();
+    let matchedFile;
+    for (const f of files) {
+        const basename = path.basename(f.filePath).toUpperCase();
+        if (basename.startsWith(normalizedId)) {
+            matchedFile = f;
+            break;
+        }
+    }
+    if (!matchedFile) {
+        throw new Error(`Issue ${issueId} not found in project ${projectId}`);
+    }
+    // Read and parse
+    const content = await fs.readFile(matchedFile.filePath, 'utf-8');
+    const parsed = safeParseYaml(content);
+    const changes = [];
+    // Apply changes
+    if (status && status !== parsed.status) {
+        changes.push(`status: ${parsed.status} → ${status}`);
+        parsed.status = status;
+    }
+    if (priority && priority !== parsed.priority) {
+        changes.push(`priority: ${parsed.priority ?? 'unset'} → ${priority}`);
+        parsed.priority = priority;
+    }
+    if (tags) {
+        const oldTags = parsed.tags || [];
+        const merged = [...new Set([...oldTags, ...tags])];
+        if (merged.length !== oldTags.length) {
+            changes.push(`tags: added ${tags.filter(t => !oldTags.includes(t)).join(', ')}`);
+            parsed.tags = merged;
+        }
+    }
+    if (note) {
+        const existing = parsed.description || '';
+        const timestamp = new Date().toISOString().slice(0, 10);
+        const appendedNote = `\n\n[${timestamp}] ${note}`;
+        parsed.description = existing + appendedNote;
+        changes.push(`note appended`);
+    }
+    if (changes.length === 0) {
+        throw new Error(`No changes to apply to ${issueId}`);
+    }
+    // Update timestamp
+    parsed.updated_at = new Date().toISOString();
+    // Write back
+    const yamlContent = stringifyYaml(parsed, { lineWidth: 0 });
+    // Write to the primary (.decibel) path
+    const writeDir = await getWritePath(projectId, ISSUES_SUBPATH);
+    await ensureDir(writeDir);
+    const writePath = path.join(writeDir, path.basename(matchedFile.filePath));
+    await fs.writeFile(writePath, yamlContent, 'utf-8');
+    log(`sentinelIssues: Updated issue ${issueId} at ${writePath} — ${changes.join(', ')}`);
+    // Build return object
+    const issue = {
+        id: parsed.id,
+        title: parsed.title,
+        project: parsed.project || projectId,
+        status: parsed.status,
+        priority: parsed.priority,
+        epicId: parsed.epic_id || parsed.epicId,
+        tags: parsed.tags,
+        created_at: parsed.created_at,
+        updated_at: parsed.updated_at,
+        description: parsed.description,
+    };
+    return { ...issue, filePath: writePath, changes };
+}
+/**
+ * Filter issues by status
+ */
+export function filterByStatus(issues, status) {
+    return issues.filter((issue) => issue.status === status);
+}
+/**
+ * Filter issues by epic ID
+ */
+export function filterByEpicId(issues, epicId) {
+    return issues.filter((issue) => issue.epicId === epicId);
+}
+//# sourceMappingURL=sentinelIssues.js.map

package/dist/sentinelIssues.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":""}

package/dist/server.js

@@ -0,0 +1,195 @@
+#!/usr/bin/env node
+// ============================================================================
+// Decibel MCP Server — Entry Point
+// ============================================================================
+// Modes:
+//   node dist/server.js              → stdio (Claude Code, Cursor)
+//   node dist/server.js --bridge     → stdio with daemon proxy (auto-detect)
+//   node dist/server.js --bridge http://...  → stdio with explicit daemon
+//   node dist/server.js --http       → HTTP only (ChatGPT, Mother)
+//   node dist/server.js --daemon     → daemon mode (HTTP + PID + graceful shutdown)
+//   node dist/server.js --daemon --stdio  → daemon + stdio from one process
+//   node dist/server.js --daemon install  → install macOS launchd plist
+//   node dist/server.js --daemon uninstall
+//   node dist/server.js --daemon status
+// ============================================================================
+import fs from 'fs';
+import path from 'path';
+import { getConfig, log } from './config.js';
+import { createKernel } from './kernel.js';
+import { StdioAdapter, HttpAdapter, BridgeAdapter } from './transports/index.js';
+import { parseHttpArgs } from './httpServer.js';
+import { checkRunning, writePid, removePid, installShutdownHandlers, handleDaemonSubcommand, getLogPath, rotateLog, checkCrashLoop, scheduleHealthReset, resetCrashes, } from './daemon.js';
+import { loadConfig } from './daemonConfig.js';
+import { getLicenseValidator } from './license.js';
+const config = getConfig();
+log(`Starting Decibel MCP Server`);
+log(`Environment: ${config.env}`);
+log(`Organization: ${config.org}`);
+log(`Root Directory: ${config.rootDir}`);
+if (process.env.DECIBEL_PRO === '1')
+    log('Pro features: ENABLED');
+if (process.env.DECIBEL_APPS === '1')
+    log('Apps: ENABLED');
+async function main() {
+    const args = process.argv;
+    const daemonMode = args.includes('--daemon');
+    // Handle daemon subcommands (install, uninstall, status) — exits process
+    if (daemonMode && handleDaemonSubcommand(args))
+        return;
+    // Handle --reset-crashes flag
+    if (args.includes('--reset-crashes')) {
+        resetCrashes();
+        process.exit(0);
+    }
+    // Parse transport config
+    const { httpMode, port, authToken, host, sseKeepaliveMs, timeoutMs, retryIntervalMs } = parseHttpArgs(args);
+    // Load daemon config file (CLI flags override config)
+    const daemonConfig = loadConfig();
+    const transportConfig = {
+        port: daemonMode ? (port || daemonConfig.daemon.port || 4888) : port,
+        host: host || (daemonMode ? daemonConfig.daemon.host : undefined),
+        authToken: authToken || daemonConfig.daemon.auth_token,
+        sseKeepaliveMs,
+        timeoutMs,
+        retryIntervalMs,
+        isDaemon: daemonMode,
+        rateLimitRpm: daemonConfig.daemon.rate_limit_rpm,
+        configLicenseKey: daemonConfig.license?.key,
+    };
+    // Daemon lifecycle: check lock, crash loop, write PID, setup shutdown
+    if (daemonMode) {
+        // Crash loop protection: exit cleanly if restarting too fast
+        if (!checkCrashLoop()) {
+            process.exit(0); // Exit 0 tells launchd to stop retrying
+        }
+        const existingPid = checkRunning();
+        if (existingPid) {
+            console.error(`Daemon already running (PID ${existingPid}).`);
+            console.error(`Kill it with: kill ${existingPid}`);
+            console.error(`Or remove stale PID: rm ~/.decibel/daemon.pid`);
+            process.exit(1);
+        }
+        writePid();
+        scheduleHealthReset(); // Reset crash counter after 5 minutes of healthy running
+        log(`Daemon: mode active, PID ${process.pid}, port ${transportConfig.port}`);
+        log(`Daemon: log file at ${getLogPath()}`);
+        // Pre-validate license key from config (fire and forget)
+        if (daemonConfig.license?.key) {
+            getLicenseValidator().prevalidate(daemonConfig.license.key);
+        }
+    }
+    // Create kernel
+    const kernel = await createKernel();
+    const adapters = [];
+    // In daemon mode, log all dispatches to dispatch.jsonl (async buffered writes + rotation)
+    if (daemonMode) {
+        const logsDir = path.join(process.env.HOME || '~', '.decibel', 'logs');
+        fs.mkdirSync(logsDir, { recursive: true });
+        const dispatchLogPath = path.join(logsDir, 'dispatch.jsonl');
+        const daemonLogPath = path.join(logsDir, 'daemon.log');
+        // Parse log rotation CLI flags
+        const maxSizeIdx = args.indexOf('--log-max-size');
+        const maxFilesIdx = args.indexOf('--log-max-files');
+        const logMaxSizeBytes = maxSizeIdx !== -1
+            ? parseInt(args[maxSizeIdx + 1], 10) * 1024 * 1024
+            : 10 * 1024 * 1024; // 10MB default
+        const logMaxFiles = maxFilesIdx !== -1
+            ? parseInt(args[maxFilesIdx + 1], 10)
+            : 3;
+        let writesSinceRotationCheck = 0;
+        // Buffered async writer — batches writes to reduce I/O
+        let writeBuffer = [];
+        let writeTimer = null;
+        const flushBuffer = async () => {
+            if (writeBuffer.length === 0)
+                return;
+            const batch = writeBuffer.join('');
+            writeBuffer = [];
+            try {
+                // Check rotation every 100 writes
+                writesSinceRotationCheck += batch.split('\n').length;
+                if (writesSinceRotationCheck >= 100) {
+                    writesSinceRotationCheck = 0;
+                    rotateLog(dispatchLogPath, logMaxSizeBytes, logMaxFiles);
+                }
+                await fs.promises.appendFile(dispatchLogPath, batch);
+            }
+            catch (err) {
+                log(`Daemon: dispatch log write error: ${err}`);
+            }
+        };
+        const writeEvent = (evt) => {
+            writeBuffer.push(JSON.stringify(evt) + '\n');
+            // Flush every 500ms or when buffer reaches 50 entries
+            if (writeBuffer.length >= 50) {
+                if (writeTimer)
+                    clearTimeout(writeTimer);
+                writeTimer = null;
+                flushBuffer();
+            }
+            else if (!writeTimer) {
+                writeTimer = setTimeout(() => {
+                    writeTimer = null;
+                    flushBuffer();
+                }, 500);
+            }
+        };
+        kernel.on('dispatch', writeEvent);
+        kernel.on('result', writeEvent);
+        kernel.on('error', writeEvent);
+        // SIGHUP: rotate daemon.log (launchd sends this for log rotation)
+        process.on('SIGHUP', () => {
+            log('Daemon: SIGHUP received, rotating logs');
+            rotateLog(dispatchLogPath, logMaxSizeBytes, logMaxFiles);
+            rotateLog(daemonLogPath, logMaxSizeBytes, logMaxFiles);
+        });
+        log(`Daemon: dispatch log at ${dispatchLogPath}`);
+        log(`Daemon: log rotation: max ${logMaxSizeBytes / 1024 / 1024}MB, keep ${logMaxFiles} files`);
+    }
+    // Start transport(s)
+    if (daemonMode) {
+        // Daemon always starts HTTP
+        const http = new HttpAdapter();
+        await http.start(kernel, transportConfig);
+        adapters.push(http);
+        // Optionally also start stdio (for dual-mode)
+        if (args.includes('--stdio')) {
+            const stdio = new StdioAdapter();
+            await stdio.start(kernel, transportConfig);
+            adapters.push(stdio);
+        }
+        // Install graceful shutdown handlers
+        installShutdownHandlers(async () => {
+            log('Daemon: stopping all transports...');
+            await Promise.all(adapters.map(a => a.stop()));
+        });
+    }
+    else if (httpMode) {
+        const http = new HttpAdapter();
+        await http.start(kernel, transportConfig);
+        adapters.push(http);
+    }
+    else if (args.includes('--bridge')) {
+        // Bridge mode: stdio with daemon proxy
+        const bridgeIdx = args.indexOf('--bridge');
+        const nextArg = args[bridgeIdx + 1];
+        // If next arg looks like a URL, use it; otherwise auto-detect
+        const explicitUrl = nextArg && nextArg.startsWith('http') ? nextArg : null;
+        const daemonUrl = explicitUrl || `http://127.0.0.1:${transportConfig.port || 4888}`;
+        const bridge = new BridgeAdapter(daemonUrl);
+        await bridge.start(kernel, transportConfig);
+        adapters.push(bridge);
+    }
+    else {
+        const stdio = new StdioAdapter();
+        await stdio.start(kernel, transportConfig);
+        adapters.push(stdio);
+    }
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    removePid(); // Clean up PID on crash
+    process.exit(1);
+});
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/test.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+/**
+ * Test script to verify all Decibel tools work correctly.
+ * Run with: npm test
+ */
+export {};
+//# sourceMappingURL=test.d.ts.map

package/dist/test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test.d.ts","sourceRoot":"","sources":["../src/test.ts"],"names":[],"mappings":";AAEA;;;GAGG"}

package/dist/test.js

@@ -0,0 +1,77 @@
+#!/usr/bin/env node
+/**
+ * Test script to verify all Decibel tools work correctly.
+ * Run with: npm test
+ */
+import { recordDesignDecision } from './tools/designer.js';
+import { recordArchDecision } from './tools/architect.js';
+import { createIssue } from './tools/sentinel.js';
+import { nextActions } from './tools/oracle.js';
+const PROJECT_ID = 'test-project';
+async function testDesigner() {
+    console.log('\n=== Testing Designer ===');
+    const result = await recordDesignDecision({
+        projectId: PROJECT_ID,
+        area: 'API',
+        summary: 'Use REST for public API endpoints',
+        details: 'We decided to use REST instead of GraphQL for the public API because:\n1. Simpler learning curve for API consumers\n2. Better caching support\n3. More predictable rate limiting',
+    });
+    console.log('Designer result:', JSON.stringify(result, null, 2));
+    return result;
+}
+async function testArchitect() {
+    console.log('\n=== Testing Architect ===');
+    const result = await recordArchDecision({
+        projectId: PROJECT_ID,
+        change: 'Migrate from monolith to microservices',
+        rationale: 'The current monolithic architecture is becoming hard to scale and deploy independently. Microservices will allow teams to deploy features independently and scale specific services based on demand.',
+        impact: 'This will require significant refactoring over the next few sprints. Team will need to set up container orchestration (K8s) and service mesh (Istio).',
+    });
+    console.log('Architect result:', JSON.stringify(result, null, 2));
+    return result;
+}
+async function testSentinel() {
+    console.log('\n=== Testing Sentinel ===');
+    const result = await createIssue({
+        projectId: PROJECT_ID,
+        severity: 'high',
+        title: 'Memory leak in auth service',
+        details: 'The auth service shows increasing memory usage over time. After ~24 hours of uptime, memory usage grows from 256MB to 2GB. Suspected cause is unclosed database connections in the session handler.',
+    });
+    console.log('Sentinel result:', JSON.stringify(result, null, 2));
+    return result;
+}
+async function testOracle() {
+    console.log('\n=== Testing Oracle ===');
+    // First without focus
+    const result1 = await nextActions({
+        projectId: PROJECT_ID,
+    });
+    console.log('Oracle result (no focus):', JSON.stringify(result1, null, 2));
+    // Then with focus
+    const result2 = await nextActions({
+        projectId: PROJECT_ID,
+        focus: 'sentinel',
+    });
+    console.log('Oracle result (focus: sentinel):', JSON.stringify(result2, null, 2));
+    return result1;
+}
+async function runAllTests() {
+    console.log('Starting Decibel Tools tests...');
+    console.log('================================');
+    try {
+        await testDesigner();
+        await testArchitect();
+        await testSentinel();
+        await testOracle();
+        console.log('\n================================');
+        console.log('All tests completed successfully!');
+        console.log('================================\n');
+    }
+    catch (error) {
+        console.error('\nTest failed:', error);
+        process.exit(1);
+    }
+}
+runAllTests();
+//# sourceMappingURL=test.js.map

package/dist/test.js.map

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

package/dist/tools/agentic/index.d.ts

@@ -0,0 +1,7 @@
+import { ToolSpec } from '../types.js';
+export declare const agenticCompilePackTool: ToolSpec;
+export declare const agenticRenderTool: ToolSpec;
+export declare const agenticLintTool: ToolSpec;
+export declare const agenticGoldenEvalTool: ToolSpec;
+export declare const agenticTools: ToolSpec[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/agentic/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tools/agentic/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAiBvC,eAAO,MAAM,sBAAsB,EAAE,QAiCpC,CAAC;AAMF,eAAO,MAAM,iBAAiB,EAAE,QA+C/B,CAAC;AAMF,eAAO,MAAM,eAAe,EAAE,QA8C7B,CAAC;AAMF,eAAO,MAAM,qBAAqB,EAAE,QAwCnC,CAAC;AAMF,eAAO,MAAM,YAAY,EAAE,QAAQ,EAKlC,CAAC"}