@ginkoai/cli 1.0.0 → 1.4.1

package/dist/commands/knowledge/graph.js

@@ -0,0 +1,199 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, graph, visualization, graphql, task-025]
+ * @related: [index.ts, api-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [chalk, axios]
+ */
+/**
+ * Graph Command (TASK-025)
+ *
+ * Visualize node relationships via GraphQL API
+ */
+import chalk from 'chalk';
+import axios from 'axios';
+import { getConfig, getApiToken } from '../graph/config.js';
+/**
+ * Visualize node and its relationship graph
+ */
+export async function graphCommand(nodeId, options) {
+    try {
+        console.log(chalk.dim(`📊 Fetching graph for node: ${nodeId}\n`));
+        // Get config and auth
+        const config = await getConfig();
+        if (!config.graphId) {
+            console.error(chalk.red('❌ No graph initialized.'));
+            console.error(chalk.dim('   Run `ginko graph init` first to create a graph.'));
+            process.exit(1);
+        }
+        const token = await getApiToken();
+        if (!token) {
+            console.error(chalk.red('❌ Not authenticated.'));
+            console.error(chalk.dim('   Run `ginko login` to authenticate.'));
+            process.exit(1);
+        }
+        // Parse relationship types filter
+        const relationshipTypes = options.types
+            ? options.types.split(',').map(t => t.trim())
+            : null;
+        // GraphQL query
+        const graphqlQuery = `
+      query NodeGraph($nodeId: ID!, $graphId: String!, $depth: Int, $relationshipTypes: [RelationshipType!]) {
+        nodeGraph(
+          nodeId: $nodeId
+          graphId: $graphId
+          depth: $depth
+          relationshipTypes: $relationshipTypes
+        ) {
+          centerNode {
+            id
+            title
+            type
+            tags
+          }
+          connectedNodes {
+            id
+            title
+            type
+            tags
+          }
+          relationships {
+            type
+            fromId
+            toId
+          }
+          depth
+        }
+      }
+    `;
+        const variables = {
+            nodeId,
+            graphId: config.graphId,
+            depth: options.depth,
+            relationshipTypes,
+        };
+        // Call GraphQL API
+        const apiUrl = config.apiUrl || process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+        const response = await axios.post(`${apiUrl}/api/graphql`, {
+            query: graphqlQuery,
+            variables,
+        }, {
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+        });
+        if (response.data.errors) {
+            console.error(chalk.red('❌ GraphQL Error:'));
+            response.data.errors.forEach((error) => {
+                console.error(chalk.red(`   ${error.message}`));
+            });
+            process.exit(1);
+        }
+        const graph = response.data.data.nodeGraph;
+        if (!graph) {
+            console.error(chalk.yellow('⚠️  Node not found or no relationships'));
+            process.exit(0);
+        }
+        // Display based on format
+        switch (options.format) {
+            case 'json':
+                console.log(JSON.stringify(graph, null, 2));
+                break;
+            case 'mermaid':
+                renderMermaid(graph);
+                break;
+            case 'tree':
+            default:
+                renderTree(graph);
+                break;
+        }
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Graph fetch failed:'));
+        if (error.response) {
+            console.error(chalk.red(`   API Error: ${error.response.status} ${error.response.statusText}`));
+            if (error.response.data?.message) {
+                console.error(chalk.red(`   ${error.response.data.message}`));
+            }
+        }
+        else if (error.request) {
+            console.error(chalk.red('   Network error: Could not reach API server'));
+        }
+        else {
+            console.error(chalk.red(`   ${error.message}`));
+        }
+        process.exit(1);
+    }
+}
+/**
+ * Render graph as a tree structure
+ */
+function renderTree(graph) {
+    console.log(chalk.bold.green('Center Node:'));
+    console.log(chalk.cyan(`  📄 ${graph.centerNode.title || graph.centerNode.id}`));
+    console.log(chalk.dim(`     Type: ${graph.centerNode.type} | ID: ${graph.centerNode.id}`));
+    if (graph.centerNode.tags && graph.centerNode.tags.length > 0) {
+        console.log(chalk.dim(`     Tags: ${graph.centerNode.tags.join(', ')}`));
+    }
+    console.log('');
+    if (graph.connectedNodes.length === 0) {
+        console.log(chalk.yellow('  No connected nodes found'));
+        return;
+    }
+    console.log(chalk.bold.green(`Connected Nodes (${graph.connectedNodes.length}):`));
+    // Group relationships by type
+    const relsByType = new Map();
+    graph.relationships.forEach(rel => {
+        if (!relsByType.has(rel.type)) {
+            relsByType.set(rel.type, []);
+        }
+        relsByType.get(rel.type).push(rel);
+    });
+    // Display grouped by relationship type
+    relsByType.forEach((rels, type) => {
+        console.log(chalk.yellow(`\n  ${type.replace(/_/g, ' ')} (${rels.length}):`));
+        rels.forEach((rel, index) => {
+            const isLast = index === rels.length - 1;
+            const prefix = isLast ? '  └─' : '  ├─';
+            // Find the target node
+            const targetId = rel.fromId === graph.centerNode.id ? rel.toId : rel.fromId;
+            const targetNode = graph.connectedNodes.find(n => n.id === targetId);
+            if (targetNode) {
+                const direction = rel.fromId === graph.centerNode.id ? '→' : '←';
+                console.log(chalk.dim(`${prefix} ${direction} ${targetNode.title || targetNode.id}`));
+                console.log(chalk.dim(`     ${targetNode.type} | ${targetNode.id}`));
+            }
+        });
+    });
+    console.log('');
+    console.log(chalk.dim(`\n📊 Total: ${graph.connectedNodes.length} nodes, ${graph.relationships.length} relationships`));
+}
+/**
+ * Render graph as Mermaid diagram
+ */
+function renderMermaid(graph) {
+    console.log('```mermaid');
+    console.log('graph TD');
+    console.log(`  center["${graph.centerNode.title || graph.centerNode.id}"]`);
+    console.log('');
+    graph.connectedNodes.forEach((node, index) => {
+        const nodeId = `node${index}`;
+        console.log(`  ${nodeId}["${node.title || node.id}"]`);
+    });
+    console.log('');
+    graph.relationships.forEach((rel, index) => {
+        const fromNode = rel.fromId === graph.centerNode.id ? 'center' : `node${graph.connectedNodes.findIndex(n => n.id === rel.fromId)}`;
+        const toNode = rel.toId === graph.centerNode.id ? 'center' : `node${graph.connectedNodes.findIndex(n => n.id === rel.toId)}`;
+        console.log(`  ${fromNode} -->|${rel.type}| ${toNode}`);
+    });
+    console.log('```');
+    console.log('');
+    console.log(chalk.dim('💡 Copy the Mermaid diagram above to visualize in:'));
+    console.log(chalk.dim('   - GitHub/GitLab markdown'));
+    console.log(chalk.dim('   - https://mermaid.live'));
+}
+//# sourceMappingURL=graph.js.map

package/dist/commands/knowledge/graph.js.map

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

package/dist/commands/knowledge/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, cli, graphql, api, task-025]
+ * @related: [search.ts, create.ts, graph.ts, api-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+/**
+ * Knowledge Commands (TASK-025)
+ *
+ * CLI commands for interacting with knowledge graph via GraphQL API:
+ * - ginko knowledge search: Semantic search across knowledge nodes
+ * - ginko knowledge create: Create new knowledge nodes
+ * - ginko knowledge graph: Visualize node relationships
+ */
+import { Command } from 'commander';
+/**
+ * Main knowledge command with subcommands
+ */
+export declare function knowledgeCommand(): Command;
+export default knowledgeCommand;
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/knowledge/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/knowledge/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOpC;;GAEG;AACH,wBAAgB,gBAAgB,YAgG/B;AAGD,eAAe,gBAAgB,CAAC"}

package/dist/commands/knowledge/index.js

@@ -0,0 +1,121 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, cli, graphql, api, task-025]
+ * @related: [search.ts, create.ts, graph.ts, api-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+/**
+ * Knowledge Commands (TASK-025)
+ *
+ * CLI commands for interacting with knowledge graph via GraphQL API:
+ * - ginko knowledge search: Semantic search across knowledge nodes
+ * - ginko knowledge create: Create new knowledge nodes
+ * - ginko knowledge graph: Visualize node relationships
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { searchCommand } from './search.js';
+import { createCommand } from './create.js';
+import { graphCommand } from './graph.js';
+import { syncCommand, rollbackCommand } from './sync.js';
+/**
+ * Main knowledge command with subcommands
+ */
+export function knowledgeCommand() {
+    const knowledge = new Command('knowledge')
+        .description('Interact with knowledge graph - search, create, and explore nodes')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Quick Start:')}
+  ${chalk.green('ginko login')}                                     ${chalk.gray('# Authenticate first')}
+  ${chalk.green('ginko knowledge search')} "auth patterns"           ${chalk.gray('# Search knowledge')}
+  ${chalk.green('ginko knowledge create')}                           ${chalk.gray('# Create new node')}
+
+${chalk.gray('Usage Examples:')}
+  ${chalk.green('ginko knowledge search')} "authentication" -l 5     ${chalk.gray('# Search with limit')}
+  ${chalk.green('ginko knowledge create')} --type ADR --title "..."  ${chalk.gray('# Create ADR')}
+  ${chalk.green('ginko knowledge graph')} adr_123 --depth 2          ${chalk.gray('# Visualize connections')}
+  ${chalk.green('ginko knowledge sync')} --dry-run                   ${chalk.gray('# Preview local→cloud sync')}
+
+${chalk.gray('Features:')}
+  ${chalk.cyan('🔍 Semantic Search')}  - Find relevant docs by meaning
+  ${chalk.cyan('🎯 Smart Create')}     - AI-assisted node creation
+  ${chalk.cyan('📊 Graph Viz')}        - Explore relationships visually
+  ${chalk.cyan('🏷️  Tag-Based')}        - Find nodes by tags
+  ${chalk.cyan('⚡ Fast & Cached')}    - GraphQL API with optimization
+
+${chalk.gray('Learn More:')}
+  ${chalk.dim('https://docs.ginko.ai/knowledge')}
+`)
+        .action(() => {
+        // When called without subcommand, show help
+        knowledge.help({ error: false });
+    });
+    // Search command
+    knowledge
+        .command('search <query>')
+        .description('Semantic search across knowledge nodes')
+        .option('-l, --limit <number>', 'Maximum results to return', '10')
+        .option('-t, --threshold <number>', 'Minimum similarity score (0-1)', '0.75')
+        .option('--type <type>', 'Filter by node type (ADR, PRD, ContextModule, Session, CodeFile)')
+        .option('--status <status>', 'Filter by status (active, archived, draft)', 'active')
+        .option('--table', 'Display results in table format')
+        .action(async (query, options) => {
+        const limit = parseInt(options.limit, 10);
+        const threshold = parseFloat(options.threshold);
+        await searchCommand(query, { ...options, limit, threshold });
+    });
+    // Create command
+    knowledge
+        .command('create')
+        .description('Create a new knowledge node')
+        .option('--type <type>', 'Node type (ADR, PRD, ContextModule, Session, CodeFile)', 'ContextModule')
+        .option('--title <title>', 'Node title')
+        .option('--content <content>', 'Node content')
+        .option('--tags <tags>', 'Comma-separated tags')
+        .option('--file <file>', 'Read content from file')
+        .option('--interactive', 'Interactive mode with prompts', true)
+        .action(async (options) => {
+        await createCommand(options);
+    });
+    // Graph command
+    knowledge
+        .command('graph <nodeId>')
+        .description('Visualize node and its relationship graph')
+        .option('-d, --depth <number>', 'Relationship depth to traverse (1-2)', '1')
+        .option('--types <types>', 'Filter relationships by type (comma-separated)')
+        .option('--format <format>', 'Output format (tree, json, mermaid)', 'tree')
+        .action(async (nodeId, options) => {
+        const depth = parseInt(options.depth, 10);
+        await graphCommand(nodeId, { ...options, depth });
+    });
+    // Sync command
+    knowledge
+        .command('sync')
+        .description('Sync local knowledge files (ADRs, PRDs) to cloud graph')
+        .option('--dry-run', 'Preview changes without executing')
+        .option('--force', 'Overwrite existing nodes (destructive)')
+        .option('--skip', 'Skip existing nodes (safe, default)', true)
+        .option('--path <path>', 'Base path to scan (default: current directory)')
+        .option('--project <id>', 'Target project/graph ID')
+        .option('--interactive', 'Interactive conflict resolution')
+        .option('--local-only', 'Skip cloud checks (for testing scanner)')
+        .action(async (options) => {
+        await syncCommand(options);
+    });
+    // Rollback command
+    knowledge
+        .command('sync:rollback <syncId>')
+        .description('Rollback a previous sync operation')
+        .action(async (syncId) => {
+        await rollbackCommand(syncId);
+    });
+    return knowledge;
+}
+// Export for use in main CLI
+export default knowledgeCommand;
+//# sourceMappingURL=index.js.map

package/dist/commands/knowledge/index.js.map

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

package/dist/commands/knowledge/search.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, search, semantic, graphql, task-025]
+ * @related: [index.ts, api-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [chalk, axios]
+ */
+interface SearchOptions {
+    limit: number;
+    threshold: number;
+    type?: string;
+    status: string;
+    table?: boolean;
+}
+/**
+ * Search knowledge nodes using semantic similarity
+ */
+export declare function searchCommand(query: string, options: SearchOptions): Promise<void>;
+export {};
+//# sourceMappingURL=search.d.ts.map

package/dist/commands/knowledge/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../../src/commands/knowledge/search.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAaH,UAAU,aAAa;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAeD;;GAEG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAyJxF"}

package/dist/commands/knowledge/search.js

@@ -0,0 +1,157 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, search, semantic, graphql, task-025]
+ * @related: [index.ts, api-client.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [chalk, axios]
+ */
+/**
+ * Search Command (TASK-025)
+ *
+ * Semantic search across knowledge nodes using GraphQL API
+ */
+import chalk from 'chalk';
+import axios from 'axios';
+import { getConfig, getApiToken } from '../graph/config.js';
+import Table from 'cli-table3';
+/**
+ * Search knowledge nodes using semantic similarity
+ */
+export async function searchCommand(query, options) {
+    try {
+        console.log(chalk.dim(`🔍 Searching for: "${query}"\n`));
+        // Get config and auth
+        const config = await getConfig();
+        if (!config.graphId) {
+            console.error(chalk.red('❌ No graph initialized.'));
+            console.error(chalk.dim('   Run `ginko graph init` first to create a graph.'));
+            process.exit(1);
+        }
+        const token = await getApiToken();
+        if (!token) {
+            console.error(chalk.red('❌ Not authenticated.'));
+            console.error(chalk.dim('   Run `ginko login` to authenticate.'));
+            process.exit(1);
+        }
+        // GraphQL query
+        const graphqlQuery = `
+      query SearchKnowledge($query: String!, $graphId: String!, $limit: Int, $minScore: Float, $type: NodeType, $status: NodeStatus) {
+        search(
+          query: $query
+          graphId: $graphId
+          limit: $limit
+          minScore: $minScore
+          type: $type
+          status: $status
+        ) {
+          node {
+            id
+            title
+            type
+            content
+            tags
+            createdAt
+          }
+          score
+          relationshipType
+        }
+      }
+    `;
+        const variables = {
+            query,
+            graphId: config.graphId,
+            limit: options.limit,
+            minScore: options.threshold,
+            type: options.type || null,
+            status: options.status.toUpperCase(),
+        };
+        // Call GraphQL API
+        const apiUrl = config.apiUrl || process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+        const response = await axios.post(`${apiUrl}/api/graphql`, {
+            query: graphqlQuery,
+            variables,
+        }, {
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${token}`,
+            },
+        });
+        if (response.data.errors) {
+            console.error(chalk.red('❌ GraphQL Error:'));
+            response.data.errors.forEach((error) => {
+                console.error(chalk.red(`   ${error.message}`));
+            });
+            process.exit(1);
+        }
+        const results = response.data.data.search;
+        if (results.length === 0) {
+            console.log(chalk.yellow('⚠️  No results found.'));
+            console.log(chalk.dim('   Try:'));
+            console.log(chalk.dim('   - Lowering the threshold: --threshold 0.5'));
+            console.log(chalk.dim('   - Removing type filter'));
+            console.log(chalk.dim('   - Using different keywords'));
+            return;
+        }
+        console.log(chalk.green(`✅ Found ${results.length} results:\n`));
+        if (options.table) {
+            // Table format
+            const table = new Table({
+                head: [chalk.cyan('Type'), chalk.cyan('Title/ID'), chalk.cyan('Score'), chalk.cyan('Relevance')],
+                colWidths: [15, 40, 10, 20],
+                wordWrap: true,
+            });
+            results.forEach((result) => {
+                const title = result.node.title || result.node.id;
+                const scoreColor = result.score >= 0.9 ? chalk.green : result.score >= 0.75 ? chalk.yellow : chalk.dim;
+                table.push([
+                    result.node.type,
+                    title.length > 35 ? title.substring(0, 32) + '...' : title,
+                    scoreColor(result.score.toFixed(3)),
+                    result.relationshipType.replace(/_/g, ' '),
+                ]);
+            });
+            console.log(table.toString());
+        }
+        else {
+            // List format
+            results.forEach((result, index) => {
+                const scoreColor = result.score >= 0.9 ? chalk.green : result.score >= 0.75 ? chalk.yellow : chalk.dim;
+                const title = result.node.title || result.node.id;
+                console.log(chalk.bold(`${index + 1}. ${title}`));
+                console.log(chalk.dim(`   Type: ${result.node.type} | Score: ${scoreColor(result.score.toFixed(3))} | ${result.relationshipType.replace(/_/g, ' ')}`));
+                console.log(chalk.dim(`   ID: ${result.node.id}`));
+                // Show tags if available
+                if (result.node.tags && result.node.tags.length > 0) {
+                    console.log(chalk.dim(`   Tags: ${result.node.tags.join(', ')}`));
+                }
+                // Show content preview (first 100 chars)
+                const contentPreview = result.node.content.substring(0, 100);
+                console.log(chalk.gray(`   ${contentPreview}${result.node.content.length > 100 ? '...' : ''}`));
+                console.log('');
+            });
+        }
+        // Summary
+        console.log(chalk.dim(`\n💡 Tip: Use "ginko knowledge graph <id>" to explore connections`));
+    }
+    catch (error) {
+        console.error(chalk.red('❌ Search failed:'));
+        if (error.response) {
+            console.error(chalk.red(`   API Error: ${error.response.status} ${error.response.statusText}`));
+            if (error.response.data?.message) {
+                console.error(chalk.red(`   ${error.response.data.message}`));
+            }
+        }
+        else if (error.request) {
+            console.error(chalk.red('   Network error: Could not reach API server'));
+            console.error(chalk.dim(`   Check your connection and API URL: ${process.env.GINKO_API_URL || 'https://app.ginkoai.com'}`));
+        }
+        else {
+            console.error(chalk.red(`   ${error.message}`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=search.js.map

package/dist/commands/knowledge/search.js.map

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

package/dist/commands/knowledge/sync.d.ts

@@ -0,0 +1,28 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [knowledge, sync, migration, cloud, task-026]
+ * @related: [index.ts, create.ts, scanner.ts, parser.ts]
+ * @priority: critical
+ * @complexity: high
+ * @dependencies: [chalk, commander]
+ */
+export interface SyncOptions {
+    dryRun?: boolean;
+    force?: boolean;
+    path?: string;
+    project?: string;
+    skip?: boolean;
+    interactive?: boolean;
+    localOnly?: boolean;
+}
+/**
+ * Main sync command
+ */
+export declare function syncCommand(options: SyncOptions): Promise<void>;
+/**
+ * Rollback command - restore state before sync
+ */
+export declare function rollbackCommand(syncId: string): Promise<void>;
+//# sourceMappingURL=sync.d.ts.map

package/dist/commands/knowledge/sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync.d.ts","sourceRoot":"","sources":["../../../src/commands/knowledge/sync.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAuBH,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwOrE;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA2BnE"}