mcp-taskflow 0.1.0

package/dist/data/fileOperations.js

@@ -0,0 +1,248 @@
+/**
+ * Atomic JSON File Operations
+ *
+ * Implements atomic write using temp file + fsync + rename.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import { randomUUID } from 'crypto';
+import { z } from 'zod';
+import { ensureDirectory } from '../config/pathResolver.js';
+/**
+ * Maximum number of retry attempts for file operations.
+ */
+const MAX_RETRIES = 5;
+/**
+ * Base delay in milliseconds for exponential backoff.
+ */
+const BASE_DELAY_MS = 100;
+/**
+ * File operation errors with detailed context
+ */
+export class FileOperationError extends Error {
+    filePath;
+    operation;
+    originalError;
+    constructor(message, filePath, operation, originalError) {
+        super(message);
+        this.filePath = filePath;
+        this.operation = operation;
+        this.originalError = originalError;
+        this.name = 'FileOperationError';
+    }
+}
+/**
+ * Parse JSON string and wrap errors
+ */
+function parseJson(content, filePath) {
+    try {
+        return JSON.parse(content);
+    }
+    catch (error) {
+        throw new FileOperationError(`Invalid JSON in file: ${filePath}`, filePath, 'read', error);
+    }
+}
+/**
+ * Validate data with Zod schema and wrap errors
+ */
+function validateWithSchema(data, schema, filePath) {
+    const result = schema.safeParse(data);
+    if (!result.success) {
+        throw new FileOperationError(`Schema validation failed for ${filePath}: ${result.error.message}`, filePath, 'read', result.error);
+    }
+    return result.data;
+}
+/**
+ * Check if error should not be retried
+ */
+function isNonRetryableError(error) {
+    return (error instanceof FileOperationError ||
+        (error instanceof Error && 'code' in error && error.code === 'ENOENT'));
+}
+/**
+ * Read and parse JSON file with Zod schema validation.
+ */
+export async function readJsonFile(filePath, schema) {
+    let lastError;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            // Read file content
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            const content = await fs.readFile(filePath, 'utf-8');
+            // Parse and validate (these throw FileOperationError on failure)
+            const parsed = parseJson(content, filePath);
+            const validated = validateWithSchema(parsed, schema, filePath);
+            return validated;
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry validation errors or ENOENT (file doesn't exist)
+            if (isNonRetryableError(error)) {
+                // If it's already a FileOperationError, throw it as-is
+                if (error instanceof FileOperationError) {
+                    throw error;
+                }
+                // Wrap ENOENT in FileOperationError
+                if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                    throw new FileOperationError(`File not found: ${filePath}`, filePath, 'read', error);
+                }
+                throw error;
+            }
+            // Retry on transient errors (EAGAIN, EBUSY, etc.)
+            if (attempt < MAX_RETRIES - 1) {
+                const delay = BASE_DELAY_MS * Math.pow(2, attempt);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                continue;
+            }
+        }
+    }
+    // All retries exhausted
+    throw new FileOperationError(`Failed to read file after ${MAX_RETRIES} attempts: ${filePath}`, filePath, 'read', lastError);
+}
+/**
+ * Write JSON file atomically using temp file + rename pattern.
+ */
+export async function writeJsonFile(filePath, data, schema) {
+    // Validate data before any file operations
+    const validationResult = schema.safeParse(data);
+    if (!validationResult.success) {
+        throw new FileOperationError(`Schema validation failed before write: ${validationResult.error.message}`, filePath, 'write', validationResult.error);
+    }
+    // Ensure parent directory exists
+    const dirPath = path.dirname(filePath);
+    await ensureDirectory(dirPath);
+    // Generate unique temp file path
+    const tempPath = `${filePath}.tmp.${randomUUID().replace(/-/g, '')}`;
+    let lastError;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            // Write to temporary file
+            await writeJsonCore(tempPath, data);
+            // Atomic rename
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            await fs.rename(tempPath, filePath);
+            // Success - clean exit
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            // Clean up temp file on failure
+            await tryDeleteFile(tempPath);
+            // Retry on transient errors
+            if (attempt < MAX_RETRIES - 1) {
+                const delay = BASE_DELAY_MS * Math.pow(2, attempt);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                continue;
+            }
+        }
+    }
+    // All retries exhausted
+    throw new FileOperationError(`Failed to write file after ${MAX_RETRIES} attempts: ${filePath}`, filePath, 'write', lastError);
+}
+/**
+ * Core write operation: serialize JSON and flush to disk.
+ */
+async function writeJsonCore(filePath, data) {
+    // Serialize with pretty-printing (2-space indentation)
+    const json = JSON.stringify(data, null, 2);
+    // Write to file
+    // eslint-disable-next-line security/detect-non-literal-fs-filename
+    const fileHandle = await fs.open(filePath, 'w');
+    try {
+        await fileHandle.writeFile(json, 'utf-8');
+        // Flush OS buffers to disk
+        await fileHandle.sync();
+    }
+    finally {
+        await fileHandle.close();
+    }
+}
+/**
+ * Safely delete a file, ignoring errors.
+ */
+async function tryDeleteFile(filePath) {
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        await fs.unlink(filePath);
+    }
+    catch {
+        // Ignore all errors - this is best-effort cleanup
+    }
+}
+/**
+ * Check if a file exists
+ *
+ * @param filePath - Absolute file path
+ * @returns true if file exists, false otherwise
+ */
+export async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Read JSON file or return default value if file doesn't exist.
+ */
+export async function readJsonFileOrDefault(filePath, schema, defaultValue) {
+    try {
+        return await readJsonFile(filePath, schema);
+    }
+    catch (error) {
+        // Return default if file doesn't exist
+        if (error instanceof FileOperationError &&
+            error.originalError instanceof Error &&
+            'code' in error.originalError &&
+            error.originalError.code === 'ENOENT') {
+            return defaultValue;
+        }
+        // Re-throw other errors (validation failures, permission errors, etc.)
+        throw error;
+    }
+}
+/**
+ * List all files in a directory.
+ */
+export async function listFiles(dirPath) {
+    try {
+        // eslint-disable-next-line security/detect-non-literal-fs-filename
+        const entries = await fs.readdir(dirPath, { withFileTypes: true });
+        return entries
+            .filter(entry => entry.isFile())
+            .map(entry => entry.name);
+    }
+    catch (error) {
+        throw new FileOperationError(`Failed to list files in directory: ${dirPath}`, dirPath, 'read', error);
+    }
+}
+/**
+ * Delete a file with retry logic.
+ */
+export async function deleteFile(filePath) {
+    let lastError;
+    for (let attempt = 0; attempt < MAX_RETRIES; attempt++) {
+        try {
+            // eslint-disable-next-line security/detect-non-literal-fs-filename
+            await fs.unlink(filePath);
+            return;
+        }
+        catch (error) {
+            lastError = error;
+            // Don't retry if file doesn't exist (already deleted)
+            if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {
+                return;
+            }
+            // Retry on transient errors
+            if (attempt < MAX_RETRIES - 1) {
+                const delay = BASE_DELAY_MS * Math.pow(2, attempt);
+                await new Promise(resolve => setTimeout(resolve, delay));
+                continue;
+            }
+        }
+    }
+    throw new FileOperationError(`Failed to delete file after ${MAX_RETRIES} attempts: ${filePath}`, filePath, 'delete', lastError);
+}
+//# sourceMappingURL=fileOperations.js.map

package/dist/data/fileOperations.js.map

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

package/dist/data/memoryStore.d.ts

@@ -0,0 +1,86 @@
+/**
+ * MemoryStore - Task snapshot and history management
+ *
+ * Provides:
+ * - Task snapshot creation and retrieval
+ * - Historical task state management
+ * - Backup functionality for task clearing
+ *
+ */
+import { type TaskDocument } from './schemas.js';
+/**
+ * Snapshot metadata
+ */
+export interface SnapshotInfo {
+    /** Snapshot filename (without extension) */
+    name: string;
+    /** Full file path */
+    path: string;
+    /** Snapshot creation timestamp */
+    timestamp: Date;
+    /** Number of tasks in snapshot */
+    taskCount: number;
+}
+/**
+ * MemoryStore - Manages task snapshots and historical data
+ */
+export declare class MemoryStore {
+    private readonly memoryDir;
+    private readonly backupDir;
+    /**
+     * Create a new MemoryStore
+     *
+     * @param dataDir - Optional data directory override (for testing)
+     */
+    constructor(dataDir?: string);
+    /**
+     * Save a task snapshot with a descriptive name
+     *
+     * @param name - Snapshot name (will be sanitized)
+     * @param document - Task document to snapshot
+     * @returns Path to saved snapshot
+     */
+    saveSnapshotAsync(name: string, document: TaskDocument): Promise<string>;
+    /**
+     * Load a task snapshot by name
+     *
+     * @param name - Snapshot filename (with or without .json extension)
+     * @returns Task document from snapshot
+     */
+    loadSnapshotAsync(name: string): Promise<TaskDocument>;
+    /**
+     * List all available snapshots
+     *
+     * @returns Array of snapshot metadata
+     */
+    listSnapshotsAsync(): Promise<SnapshotInfo[]>;
+    /**
+     * Delete a snapshot by name
+     *
+     * @param name - Snapshot filename (with or without .json extension)
+     * @returns True if deleted, false if not found
+     */
+    deleteSnapshotAsync(name: string): Promise<boolean>;
+    /**
+     * Create a backup of completed tasks
+     * Used when clearing all tasks to preserve history
+     *
+     * @param document - Task document to backup
+     * @returns Path to backup file
+     */
+    createBackupAsync(document: TaskDocument): Promise<string>;
+    /**
+     * Sanitize filename to prevent path traversal and filesystem issues
+     *
+     * Removes:
+     * - Path separators (/, \)
+     * - Null bytes
+     * - Control characters
+     * - Leading/trailing dots and spaces
+     *
+     * @param filename - Raw filename
+     * @returns Sanitized filename safe for filesystem
+     */
+    private sanitizeFilename;
+}
+//# sourceMappingURL=memoryStore.d.ts.map

package/dist/data/memoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memoryStore.d.ts","sourceRoot":"","sources":["../../src/data/memoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,YAAY,EAAsB,MAAM,cAAc,CAAC;AAIrE;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,kCAAkC;IAClC,SAAS,EAAE,IAAI,CAAC;IAChB,kCAAkC;IAClC,SAAS,EAAE,MAAM,CAAC;CACnB;AAsBD;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM;IAM5B;;;;;;OAMG;IACU,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAiCrF;;;;;OAKG;IACU,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAyBnE;;;;OAIG;IACU,kBAAkB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAwC1D;;;;;OAKG;IACU,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAsBhE;;;;;;OAMG;IACU,iBAAiB,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBvE;;;;;;;;;;;OAWG;IACH,OAAO,CAAC,gBAAgB;CAezB"}

package/dist/data/memoryStore.js

@@ -0,0 +1,216 @@
+/**
+ * MemoryStore - Task snapshot and history management
+ *
+ * Provides:
+ * - Task snapshot creation and retrieval
+ * - Historical task state management
+ * - Backup functionality for task clearing
+ *
+ */
+import { writeJsonFile, readJsonFile, fileExists, listFiles, deleteFile } from './fileOperations.js';
+import { TaskDocumentSchema } from './schemas.js';
+import { getDataPath } from '../config/pathResolver.js';
+import path from 'path';
+/**
+ * Maximum filename length to prevent filesystem issues
+ */
+const MAX_FILENAME_LENGTH = 100;
+/**
+ * Maximum snapshot file size (10MB) to prevent DoS
+ */
+const MAX_SNAPSHOT_SIZE_BYTES = 10 * 1024 * 1024;
+/**
+ * Memory subdirectory name
+ */
+const MEMORY_DIR = 'memory';
+/**
+ * Backup subdirectory name
+ */
+const BACKUP_DIR = 'backups';
+/**
+ * MemoryStore - Manages task snapshots and historical data
+ */
+export class MemoryStore {
+    memoryDir;
+    backupDir;
+    /**
+     * Create a new MemoryStore
+     *
+     * @param dataDir - Optional data directory override (for testing)
+     */
+    constructor(dataDir) {
+        const baseDir = dataDir ?? getDataPath('', dataDir);
+        this.memoryDir = path.join(baseDir, MEMORY_DIR);
+        this.backupDir = path.join(baseDir, BACKUP_DIR);
+    }
+    /**
+     * Save a task snapshot with a descriptive name
+     *
+     * @param name - Snapshot name (will be sanitized)
+     * @param document - Task document to snapshot
+     * @returns Path to saved snapshot
+     */
+    async saveSnapshotAsync(name, document) {
+        // Sanitize and validate filename
+        const sanitizedName = this.sanitizeFilename(name);
+        if (sanitizedName.length === 0) {
+            throw new Error('Snapshot name cannot be empty after sanitization');
+        }
+        if (sanitizedName.length > MAX_FILENAME_LENGTH) {
+            throw new Error(`Snapshot name too long (max ${MAX_FILENAME_LENGTH} characters after sanitization)`);
+        }
+        // Create snapshot filename with timestamp
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const filename = `${sanitizedName}_${timestamp}.json`;
+        const filePath = path.join(this.memoryDir, filename);
+        // Validate file size before writing
+        const jsonSize = JSON.stringify(document).length;
+        if (jsonSize > MAX_SNAPSHOT_SIZE_BYTES) {
+            throw new Error(`Snapshot too large (${jsonSize} bytes, max ${MAX_SNAPSHOT_SIZE_BYTES})`);
+        }
+        // Write snapshot atomically
+        await writeJsonFile(filePath, document, TaskDocumentSchema);
+        return filePath;
+    }
+    /**
+     * Load a task snapshot by name
+     *
+     * @param name - Snapshot filename (with or without .json extension)
+     * @returns Task document from snapshot
+     */
+    async loadSnapshotAsync(name) {
+        // Add .json extension if not present
+        const filename = name.endsWith('.json') ? name : `${name}.json`;
+        const filePath = path.join(this.memoryDir, filename);
+        // Validate path doesn't escape memory directory
+        const resolvedPath = path.resolve(filePath);
+        const resolvedMemoryDir = path.resolve(this.memoryDir);
+        if (!resolvedPath.startsWith(resolvedMemoryDir)) {
+            throw new Error('Invalid snapshot path: directory traversal detected');
+        }
+        // Check if file exists
+        if (!(await fileExists(filePath))) {
+            throw new Error(`Snapshot not found: ${name}`);
+        }
+        // Read and validate snapshot
+        // Zod parsing ensures all defaults are applied
+        const document = await readJsonFile(filePath, TaskDocumentSchema);
+        // Return as TaskDocument (Zod ensures schema compliance including defaults)
+        return document;
+    }
+    /**
+     * List all available snapshots
+     *
+     * @returns Array of snapshot metadata
+     */
+    async listSnapshotsAsync() {
+        // Ensure memory directory exists
+        if (!(await fileExists(this.memoryDir))) {
+            return [];
+        }
+        // List all JSON files in memory directory
+        const allFiles = await listFiles(this.memoryDir);
+        const files = allFiles.filter(f => f.endsWith('.json'));
+        // Load metadata for each snapshot
+        const snapshots = [];
+        for (const file of files) {
+            try {
+                const filePath = path.join(this.memoryDir, file);
+                const document = await readJsonFile(filePath, TaskDocumentSchema);
+                // Extract timestamp from filename (format: name_YYYY-MM-DDTHH-MM-SS-sssZ.json)
+                const timestampMatch = file.match(/_(\d{4}-\d{2}-\d{2}T\d{2}-\d{2}-\d{2}-\d{3}Z)\.json$/);
+                const timestamp = timestampMatch
+                    ? new Date(timestampMatch[1].replace(/-/g, ':').replace(/T(\d{2}):(\d{2}):(\d{2})/, 'T$1:$2:$3.'))
+                    : new Date();
+                snapshots.push({
+                    name: file.replace(/\.json$/, ''),
+                    path: filePath,
+                    timestamp,
+                    taskCount: document.tasks?.length ?? 0,
+                });
+            }
+            catch (error) {
+                // Skip corrupted snapshots
+                console.warn(`Failed to load snapshot ${file}:`, error);
+            }
+        }
+        // Sort by timestamp (newest first)
+        return snapshots.sort((a, b) => b.timestamp.getTime() - a.timestamp.getTime());
+    }
+    /**
+     * Delete a snapshot by name
+     *
+     * @param name - Snapshot filename (with or without .json extension)
+     * @returns True if deleted, false if not found
+     */
+    async deleteSnapshotAsync(name) {
+        const filename = name.endsWith('.json') ? name : `${name}.json`;
+        const filePath = path.join(this.memoryDir, filename);
+        // Validate path doesn't escape memory directory
+        const resolvedPath = path.resolve(filePath);
+        const resolvedMemoryDir = path.resolve(this.memoryDir);
+        if (!resolvedPath.startsWith(resolvedMemoryDir)) {
+            throw new Error('Invalid snapshot path: directory traversal detected');
+        }
+        // Check if file exists
+        if (!(await fileExists(filePath))) {
+            return false;
+        }
+        // Delete snapshot
+        await deleteFile(filePath);
+        return true;
+    }
+    /**
+     * Create a backup of completed tasks
+     * Used when clearing all tasks to preserve history
+     *
+     * @param document - Task document to backup
+     * @returns Path to backup file
+     */
+    async createBackupAsync(document) {
+        // Filter to only completed tasks
+        const completedTasks = document.tasks.filter(t => t.status === 'completed');
+        if (completedTasks.length === 0) {
+            throw new Error('No completed tasks to backup');
+        }
+        const backupDocument = {
+            version: document.version,
+            tasks: completedTasks,
+        };
+        // Create backup filename with timestamp
+        const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+        const filename = `backup_${timestamp}.json`;
+        const filePath = path.join(this.backupDir, filename);
+        // Write backup atomically
+        await writeJsonFile(filePath, backupDocument, TaskDocumentSchema);
+        return filePath;
+    }
+    /**
+     * Sanitize filename to prevent path traversal and filesystem issues
+     *
+     * Removes:
+     * - Path separators (/, \)
+     * - Null bytes
+     * - Control characters
+     * - Leading/trailing dots and spaces
+     *
+     * @param filename - Raw filename
+     * @returns Sanitized filename safe for filesystem
+     */
+    sanitizeFilename(filename) {
+        return filename
+            // Remove path separators and null bytes
+            .replace(/[/\\:\0]/g, '')
+            // Remove control characters (ASCII 0-31, 127)
+            .replace(/[\x00-\x1F\x7F]/g, '')
+            // Remove characters that are problematic on Windows
+            .replace(/[<>:"|?*]/g, '')
+            // Replace spaces with underscores
+            .replace(/\s+/g, '_')
+            // Remove leading/trailing dots and spaces
+            .replace(/^[.\s]+|[.\s]+$/g, '')
+            // Collapse multiple underscores
+            .replace(/_+/g, '_');
+    }
+}
+//# sourceMappingURL=memoryStore.js.map

package/dist/data/memoryStore.js.map

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

package/dist/data/rulesStore.d.ts

@@ -0,0 +1,63 @@
+/**
+ * RulesStore - Project-specific coding rules management
+ *
+ * Provides:
+ * - Loading and saving project coding standards
+ * - Markdown-based rules storage
+ * - Validation and size limits
+ *
+ */
+/**
+ * RulesStore - Manages project-specific coding rules
+ */
+export declare class RulesStore {
+    private readonly rulesFilePath;
+    /**
+     * Create a new RulesStore
+     *
+     * @param dataDir - Optional data directory override (for testing)
+     */
+    constructor(dataDir?: string);
+    /**
+     * Check if project rules exist
+     *
+     * @returns True if rules file exists
+     */
+    rulesExistAsync(): Promise<boolean>;
+    /**
+     * Load project rules
+     *
+     * @returns Rules content as markdown string
+     */
+    loadRulesAsync(): Promise<string>;
+    /**
+     * Save project rules
+     *
+     * Validates markdown content and size before saving
+     *
+     * @param content - Rules content as markdown string
+     */
+    saveRulesAsync(content: string): Promise<void>;
+    /**
+     * Initialize project rules with default template
+     *
+     * Only creates file if it doesn't already exist
+     *
+     * @returns True if created, false if already exists
+     */
+    initializeRulesAsync(): Promise<boolean>;
+    /**
+     * Update project rules (append or replace sections)
+     *
+     * @param updates - Markdown content to append or section replacements
+     * @param mode - 'append' to add to end, 'replace' to overwrite
+     */
+    updateRulesAsync(updates: string, mode?: 'append' | 'replace'): Promise<void>;
+    /**
+     * Delete project rules
+     *
+     * @returns True if deleted, false if didn't exist
+     */
+    deleteRulesAsync(): Promise<boolean>;
+}
+//# sourceMappingURL=rulesStore.d.ts.map

package/dist/data/rulesStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rulesStore.d.ts","sourceRoot":"","sources":["../../src/data/rulesStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAuDH;;GAEG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IAEvC;;;;OAIG;gBACS,OAAO,CAAC,EAAE,MAAM;IAI5B;;;;OAIG;IACU,eAAe,IAAI,OAAO,CAAC,OAAO,CAAC;IAIhD;;;;OAIG;IACU,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC;IAmB9C;;;;;;OAMG;IACU,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C3D;;;;;;OAMG;IACU,oBAAoB,IAAI,OAAO,CAAC,OAAO,CAAC;IASrD;;;;;OAKG;IACU,gBAAgB,CAC3B,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,QAAQ,GAAG,SAAoB,GACpC,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;OAIG;IACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;CASlD"}