@ginkoai/cli 1.0.0 → 1.4.1

package/dist/lib/session-cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-cursor.d.ts","sourceRoot":"","sources":["../../src/lib/session-cursor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAQH;;;GAGG;AACH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,EAAE,IAAI,CAAC;IACd,WAAW,EAAE,IAAI,CAAC;IAClB,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC5B,gBAAgB,CAAC,EAAE,GAAG,CAAC;CACxB;AA2GD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,GAAG,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,CAAC,CAqBzB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAe3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,GAC9B,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;CAC9B,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CA6BhC;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAO3E;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAIlE;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,CAAC,CA2BrD;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAwBhC"}

package/dist/lib/session-cursor.js

@@ -0,0 +1,250 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-04
+ * @tags: [session, cursor, event-stream, adr-043, multi-context]
+ * @related: [commands/start/index.ts, utils/helpers.ts, lib/write-dispatcher/write-dispatcher.ts]
+ * @priority: critical
+ * @complexity: medium
+ * @dependencies: [fs-extra, simple-git]
+ */
+import fs from 'fs-extra';
+import path from 'path';
+import { v4 as uuidv4 } from 'uuid';
+import simpleGit from 'simple-git';
+import { getGinkoDir, getUserEmail, getProjectInfo } from '../utils/helpers.js';
+/**
+ * Get path to local cursor storage file
+ */
+async function getCursorStoragePath() {
+    const ginkoDir = await getGinkoDir();
+    const userEmail = await getUserEmail();
+    const userSlug = userEmail.replace('@', '-at-').replace(/\./g, '-');
+    const sessionDir = path.join(ginkoDir, 'sessions', userSlug);
+    await fs.ensureDir(sessionDir);
+    return path.join(sessionDir, 'cursors.json');
+}
+/**
+ * Load cursor storage from disk
+ */
+async function loadCursorStorage() {
+    const storagePath = await getCursorStoragePath();
+    if (await fs.pathExists(storagePath)) {
+        try {
+            const data = await fs.readJSON(storagePath);
+            // Convert date strings back to Date objects
+            Object.values(data.cursors).forEach((cursor) => {
+                cursor.started = new Date(cursor.started);
+                cursor.last_active = new Date(cursor.last_active);
+            });
+            return data;
+        }
+        catch (error) {
+            console.warn('[CURSOR] Failed to load cursor storage:', error);
+        }
+    }
+    return {
+        version: '1.0',
+        cursors: {},
+        last_updated: new Date().toISOString()
+    };
+}
+/**
+ * Save cursor storage to disk
+ */
+async function saveCursorStorage(storage) {
+    const storagePath = await getCursorStoragePath();
+    storage.last_updated = new Date().toISOString();
+    await fs.writeJSON(storagePath, storage, { spaces: 2 });
+}
+/**
+ * Generate event ID for cursor position
+ * Format: evt_<timestamp>_<random>
+ */
+function generateEventId() {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return `evt_${timestamp}_${random}`;
+}
+/**
+ * Get current git branch
+ */
+async function getCurrentBranch() {
+    try {
+        const git = simpleGit();
+        const status = await git.status();
+        return status.current || 'main';
+    }
+    catch (error) {
+        console.warn('[CURSOR] Failed to get git branch:', error);
+        return 'main';
+    }
+}
+/**
+ * Get organization ID from project info or config
+ */
+async function getOrganizationId() {
+    try {
+        const ginkoDir = await getGinkoDir();
+        const configPath = path.join(ginkoDir, 'config.json');
+        if (await fs.pathExists(configPath)) {
+            const config = await fs.readJSON(configPath);
+            if (config.organization?.id) {
+                return config.organization.id;
+            }
+        }
+    }
+    catch (error) {
+        console.warn('[CURSOR] Failed to load organization ID:', error);
+    }
+    // Fallback to user-based organization
+    const userEmail = await getUserEmail();
+    return `org_${userEmail.split('@')[0]}`;
+}
+/**
+ * Create a new session cursor
+ */
+export async function createCursor(params) {
+    const storage = await loadCursorStorage();
+    const userEmail = await getUserEmail();
+    const cursor = {
+        id: uuidv4(),
+        user_id: userEmail,
+        organization_id: params.organizationId,
+        project_id: params.projectId,
+        branch: params.branch,
+        current_event_id: generateEventId(),
+        started: new Date(),
+        last_active: new Date(),
+        status: 'active',
+        context_snapshot: params.contextSnapshot
+    };
+    storage.cursors[cursor.id] = cursor;
+    await saveCursorStorage(storage);
+    return cursor;
+}
+/**
+ * Resume an existing cursor
+ */
+export async function resumeCursor(cursorId) {
+    const storage = await loadCursorStorage();
+    const cursor = storage.cursors[cursorId];
+    if (!cursor) {
+        throw new Error(`Cursor not found: ${cursorId}`);
+    }
+    cursor.status = 'active';
+    cursor.last_active = new Date();
+    storage.cursors[cursorId] = cursor;
+    await saveCursorStorage(storage);
+    return cursor;
+}
+/**
+ * Update cursor properties
+ */
+export async function updateCursor(cursorId, updates) {
+    const storage = await loadCursorStorage();
+    const cursor = storage.cursors[cursorId];
+    if (!cursor) {
+        throw new Error(`Cursor not found: ${cursorId}`);
+    }
+    // Merge updates
+    Object.assign(cursor, updates);
+    cursor.last_active = new Date();
+    storage.cursors[cursorId] = cursor;
+    await saveCursorStorage(storage);
+    return cursor;
+}
+/**
+ * Find a cursor matching the given filters
+ */
+export async function findCursor(filters) {
+    const storage = await loadCursorStorage();
+    const userEmail = await getUserEmail();
+    const cursors = Object.values(storage.cursors).filter(cursor => cursor.user_id === userEmail);
+    for (const cursor of cursors) {
+        let matches = true;
+        if (filters.branch && cursor.branch !== filters.branch) {
+            matches = false;
+        }
+        if (filters.projectId && cursor.project_id !== filters.projectId) {
+            matches = false;
+        }
+        if (filters.status && cursor.status !== filters.status) {
+            matches = false;
+        }
+        if (matches) {
+            return cursor;
+        }
+    }
+    return null;
+}
+/**
+ * List all cursors for a user
+ */
+export async function listCursors(userId) {
+    const storage = await loadCursorStorage();
+    const userEmail = userId || await getUserEmail();
+    return Object.values(storage.cursors)
+        .filter(cursor => cursor.user_id === userEmail)
+        .sort((a, b) => b.last_active.getTime() - a.last_active.getTime());
+}
+/**
+ * Delete a cursor
+ */
+export async function deleteCursor(cursorId) {
+    const storage = await loadCursorStorage();
+    delete storage.cursors[cursorId];
+    await saveCursorStorage(storage);
+}
+/**
+ * Create or resume cursor for current context
+ * This is the main entry point for session management
+ */
+export async function getOrCreateCursor(options) {
+    const branch = options.branch || await getCurrentBranch();
+    const projectInfo = await getProjectInfo();
+    const projectId = options.projectId || projectInfo.name;
+    const organizationId = await getOrganizationId();
+    // Try to find existing paused cursor for this branch + project
+    const existingCursor = await findCursor({
+        branch,
+        projectId,
+        status: 'paused'
+    });
+    if (existingCursor) {
+        // Resume existing cursor
+        const cursor = await resumeCursor(existingCursor.id);
+        return { cursor, isNew: false };
+    }
+    // Create new cursor
+    const cursor = await createCursor({
+        branch,
+        projectId,
+        organizationId
+    });
+    return { cursor, isNew: true };
+}
+/**
+ * Pause current active cursor
+ */
+export async function pauseCurrentCursor(options) {
+    const branch = options.branch || await getCurrentBranch();
+    const projectInfo = await getProjectInfo();
+    const projectId = options.projectId || projectInfo.name;
+    const cursor = await findCursor({
+        branch,
+        projectId,
+        status: 'active'
+    });
+    if (!cursor) {
+        return null;
+    }
+    const updates = {
+        status: 'paused'
+    };
+    if (options.finalEventId) {
+        updates.current_event_id = options.finalEventId;
+    }
+    return await updateCursor(cursor.id, updates);
+}
+//# sourceMappingURL=session-cursor.js.map

package/dist/lib/session-cursor.js.map

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

package/dist/lib/sync/conflict-detector.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, conflict-detection, duplicate-check, task-026]
+ * @related: [scanner.ts, sync.ts, uploader.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [axios]
+ */
+import { LocalNode } from './scanner.js';
+export type ConflictResolution = 'skip' | 'overwrite' | 'merge';
+export interface CloudNode {
+    id: string;
+    type: string;
+    title: string;
+    status: string;
+    tags: string[];
+    hash?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface Conflict {
+    local: LocalNode;
+    cloud: CloudNode;
+    resolution: ConflictResolution;
+    reason: string;
+}
+/**
+ * Detect conflicts between local and cloud nodes
+ */
+export declare function detectConflicts(localNodes: LocalNode[], graphId: string, token: string, apiUrl?: string): Promise<Conflict[]>;
+/**
+ * Apply resolution strategy to conflicts
+ */
+export declare function applyResolution(conflicts: Conflict[], resolution: ConflictResolution): Conflict[];
+/**
+ * Get summary of conflicts by reason
+ */
+export declare function getConflictSummary(conflicts: Conflict[]): Record<string, number>;
+//# sourceMappingURL=conflict-detector.d.ts.map

package/dist/lib/sync/conflict-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-detector.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/conflict-detector.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzC,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;IACjB,UAAU,EAAE,kBAAkB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,SAAS,EAAE,EACvB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,QAAQ,EAAE,CAAC,CAqCrB;AA+DD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,SAAS,EAAE,QAAQ,EAAE,EACrB,UAAU,EAAE,kBAAkB,GAC7B,QAAQ,EAAE,CAKZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKhF"}

package/dist/lib/sync/conflict-detector.js

@@ -0,0 +1,124 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, conflict-detection, duplicate-check, task-026]
+ * @related: [scanner.ts, sync.ts, uploader.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [axios]
+ */
+/**
+ * Conflict Detector (TASK-026)
+ *
+ * Detects conflicts between local and cloud knowledge nodes:
+ * - Matches nodes by title + type
+ * - Compares content hashes
+ * - Supports multiple resolution strategies:
+ *   - skip: Keep cloud version (safe default)
+ *   - overwrite: Replace with local version
+ *   - merge: Future support for intelligent merging
+ */
+import axios from 'axios';
+/**
+ * Detect conflicts between local and cloud nodes
+ */
+export async function detectConflicts(localNodes, graphId, token, apiUrl) {
+    const conflicts = [];
+    try {
+        // Fetch existing nodes from cloud
+        const cloudNodes = await fetchCloudNodes(graphId, token, apiUrl);
+        // Create lookup map for cloud nodes (by title + type)
+        const cloudNodeMap = new Map();
+        cloudNodes.forEach(node => {
+            const key = `${node.type}:${node.title}`;
+            cloudNodeMap.set(key, node);
+        });
+        // Check each local node for conflicts
+        for (const localNode of localNodes) {
+            const key = `${localNode.type}:${localNode.title}`;
+            const cloudNode = cloudNodeMap.get(key);
+            if (cloudNode) {
+                // Conflict detected - same title + type exists
+                const reason = determineConflictReason(localNode, cloudNode);
+                conflicts.push({
+                    local: localNode,
+                    cloud: cloudNode,
+                    resolution: 'skip', // Default to safe option
+                    reason,
+                });
+            }
+        }
+    }
+    catch (error) {
+        throw new Error(`Failed to detect conflicts: ${error.message}`);
+    }
+    return conflicts;
+}
+/**
+ * Fetch existing nodes from cloud API
+ */
+async function fetchCloudNodes(graphId, token, apiUrl) {
+    const baseUrl = apiUrl || process.env.GINKO_API_URL || 'https://app.ginkoai.com';
+    try {
+        const response = await axios.get(`${baseUrl}/api/v1/knowledge/nodes`, {
+            params: {
+                graphId,
+                limit: 1000, // Fetch all nodes
+            },
+            headers: {
+                'Authorization': `Bearer ${token}`,
+                'Content-Type': 'application/json',
+            },
+        });
+        return response.data.nodes || [];
+    }
+    catch (error) {
+        if (error.response?.status === 404) {
+            // Graph doesn't exist or has no nodes
+            return [];
+        }
+        throw new Error(`Failed to fetch cloud nodes: ${error.message}`);
+    }
+}
+/**
+ * Determine why nodes conflict
+ */
+function determineConflictReason(local, cloud) {
+    // Check if content is different
+    if (local.hash && cloud.hash && local.hash !== cloud.hash) {
+        return 'Content differs';
+    }
+    // Check if status changed
+    if (local.status !== cloud.status) {
+        return `Status differs (local: ${local.status}, cloud: ${cloud.status})`;
+    }
+    // Check if tags changed
+    const localTags = new Set(local.tags);
+    const cloudTags = new Set(cloud.tags);
+    if (localTags.size !== cloudTags.size ||
+        ![...localTags].every(tag => cloudTags.has(tag))) {
+        return 'Tags differ';
+    }
+    // Nodes are essentially the same
+    return 'Exact duplicate';
+}
+/**
+ * Apply resolution strategy to conflicts
+ */
+export function applyResolution(conflicts, resolution) {
+    return conflicts.map(conflict => ({
+        ...conflict,
+        resolution,
+    }));
+}
+/**
+ * Get summary of conflicts by reason
+ */
+export function getConflictSummary(conflicts) {
+    return conflicts.reduce((acc, conflict) => {
+        acc[conflict.reason] = (acc[conflict.reason] || 0) + 1;
+        return acc;
+    }, {});
+}
+//# sourceMappingURL=conflict-detector.js.map

package/dist/lib/sync/conflict-detector.js.map

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

package/dist/lib/sync/logger.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @fileType: utility
+ * @status: current
+ * @updated: 2025-11-07
+ * @tags: [sync, logging, rollback, audit, task-026]
+ * @related: [sync.ts, uploader.ts]
+ * @priority: medium
+ * @complexity: low
+ * @dependencies: [fs]
+ */
+export interface SyncLog {
+    syncId: string;
+    timestamp: string;
+    graphId: string;
+    nodesScanned: number;
+    nodesUploaded: number;
+    nodesFailed: number;
+    nodesSkipped: number;
+    relationshipsCreated: number;
+    conflicts: number;
+    resolution: string;
+    duration: number;
+    uploadedNodes?: Array<{
+        id: string;
+        type: string;
+        title: string;
+    }>;
+}
+/**
+ * Sync logger for tracking sync operations
+ */
+export declare class SyncLogger {
+    private graphId;
+    private syncId;
+    private logDir;
+    private logFile;
+    constructor(graphId: string);
+    /**
+     * Initialize logger (create directories)
+     */
+    init(): Promise<void>;
+    /**
+     * Log sync operation
+     */
+    logSync(log: Omit<SyncLog, 'syncId'>): Promise<void>;
+    /**
+     * Append to sync history
+     */
+    private appendToHistory;
+    /**
+     * Get sync log by ID
+     */
+    getSyncLog(syncId: string): Promise<SyncLog | null>;
+    /**
+     * Get all sync logs
+     */
+    getAllSyncLogs(): Promise<SyncLog[]>;
+    /**
+     * Get sync history from JSONL file
+     */
+    getSyncHistory(): Promise<SyncLog[]>;
+    /**
+     * Generate unique sync ID
+     */
+    private generateSyncId;
+    /**
+     * Get log file path
+     */
+    getLogPath(): string;
+    /**
+     * Get sync ID
+     */
+    getSyncId(): string;
+    /**
+     * Clean up old logs (keep last N)
+     */
+    cleanupOldLogs(keepCount?: number): Promise<void>;
+}
+/**
+ * Get sync statistics
+ */
+export declare function getSyncStats(logs: SyncLog[]): {
+    totalSyncs: number;
+    totalNodesUploaded: number;
+    totalRelationships: number;
+    averageDuration: number;
+    successRate: number;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/lib/sync/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/logger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;KACf,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,OAAO,CAAS;gBAEZ,OAAO,EAAE,MAAM;IAS3B;;OAEG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ3B;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D;;OAEG;YACW,eAAe;IAa7B;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAWzD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAsB1C;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;IAiB1C;;OAEG;IACH,OAAO,CAAC,cAAc;IAKtB;;OAEG;IACH,UAAU,IAAI,MAAM;IAIpB;;OAEG;IACH,SAAS,IAAI,MAAM;IAInB;;OAEG;IACG,cAAc,CAAC,SAAS,GAAE,MAAW,GAAG,OAAO,CAAC,IAAI,CAAC;CAyB5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;CACrB,CAyBA"}