@cleocode/cleo 2026.2.5

package/dist/store/git-checkpoint.js

@@ -0,0 +1,304 @@
+/**
+ * Git checkpoint system for CLEO state files.
+ * Ported from lib/data/git-checkpoint.sh
+ *
+ * Opt-in automatic git commits of .cleo/ state files at semantic
+ * boundaries (save_json, session end) with debounce to prevent commit noise.
+ * All git errors are suppressed - checkpointing is never fatal.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { readFile, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import { execFile } from 'node:child_process';
+import { promisify } from 'node:util';
+import { join } from 'node:path';
+import { getCleoDir, getConfigPath } from '../core/paths.js';
+import { readJson } from './json.js';
+const execFileAsync = promisify(execFile);
+/**
+ * State files eligible for checkpointing (relative to .cleo/).
+ * Includes both JSON and SQLite data files — `getChangedStateFiles()` skips
+ * files that don't exist on disk, so listing both engines is safe.
+ */
+const STATE_FILES = [
+    // Core data (JSON engine)
+    'todo.json',
+    'todo-archive.json',
+    'sessions.json',
+    // Core data (SQLite engine)
+    'tasks.db',
+    // Always-present files
+    'config.json',
+    'todo-log.jsonl',
+    '.sequence',
+    'project-context.json',
+    // Metrics
+    'metrics/COMPLIANCE.jsonl',
+    'metrics/SESSIONS.jsonl',
+    'metrics/TOKEN_USAGE.jsonl',
+    'metrics/BENCHMARK.jsonl',
+];
+/** Debounce state file name (relative to .cleo/). */
+const CHECKPOINT_STATE_FILE = '.git-checkpoint-state';
+/**
+ * Load checkpoint configuration from config.json.
+ * @task T4552
+ */
+export async function loadCheckpointConfig(cwd) {
+    try {
+        const configPath = getConfigPath(cwd);
+        const config = await readJson(configPath);
+        const gc = config?.gitCheckpoint;
+        return {
+            enabled: gc?.enabled !== false,
+            debounceMinutes: typeof gc?.debounceMinutes === 'number' ? gc.debounceMinutes : 5,
+            messagePrefix: typeof gc?.messagePrefix === 'string' ? gc.messagePrefix : 'chore(cleo):',
+            noVerify: gc?.noVerify !== false,
+        };
+    }
+    catch {
+        return {
+            enabled: true,
+            debounceMinutes: 5,
+            messagePrefix: 'chore(cleo):',
+            noVerify: true,
+        };
+    }
+}
+/**
+ * Run a git command, suppressing errors.
+ * @task T4552
+ */
+async function gitCommand(args, cwd) {
+    try {
+        const result = await execFileAsync('git', args, {
+            cwd: cwd ?? process.cwd(),
+            timeout: 10_000,
+        });
+        return { stdout: result.stdout.trim(), success: true };
+    }
+    catch {
+        return { stdout: '', success: false };
+    }
+}
+/**
+ * Check if we're inside a git work tree.
+ * @task T4552
+ */
+async function isGitRepo(cwd) {
+    const result = await gitCommand(['rev-parse', '--is-inside-work-tree'], cwd);
+    return result.success && result.stdout === 'true';
+}
+/**
+ * Check if a merge is in progress.
+ * @task T4552
+ */
+async function isMergeInProgress(cwd) {
+    const result = await gitCommand(['rev-parse', '--git-dir'], cwd);
+    if (!result.success)
+        return false;
+    return existsSync(join(result.stdout, 'MERGE_HEAD'));
+}
+/**
+ * Check if HEAD is detached.
+ * @task T4552
+ */
+async function isDetachedHead(cwd) {
+    const result = await gitCommand(['symbolic-ref', 'HEAD'], cwd);
+    return !result.success;
+}
+/**
+ * Check if a rebase is in progress.
+ * @task T4552
+ */
+async function isRebaseInProgress(cwd) {
+    const result = await gitCommand(['rev-parse', '--git-dir'], cwd);
+    if (!result.success)
+        return false;
+    return existsSync(join(result.stdout, 'rebase-merge')) ||
+        existsSync(join(result.stdout, 'rebase-apply'));
+}
+/**
+ * Record the current time as the last checkpoint time.
+ * @task T4552
+ */
+async function recordCheckpointTime(cleoDir) {
+    try {
+        const stateFile = join(cleoDir, CHECKPOINT_STATE_FILE);
+        await writeFile(stateFile, String(Math.floor(Date.now() / 1000)));
+    }
+    catch {
+        // Non-fatal
+    }
+}
+/**
+ * Get the epoch time of the last checkpoint.
+ * @task T4552
+ */
+async function getLastCheckpointTime(cleoDir) {
+    try {
+        const stateFile = join(cleoDir, CHECKPOINT_STATE_FILE);
+        const content = await readFile(stateFile, 'utf-8');
+        const epoch = parseInt(content.trim(), 10);
+        return isNaN(epoch) ? 0 : epoch;
+    }
+    catch {
+        return 0;
+    }
+}
+/**
+ * Get list of state files with pending changes.
+ * @task T4552
+ */
+async function getChangedStateFiles(cleoDir, cwd) {
+    const changed = [];
+    for (const stateFile of STATE_FILES) {
+        const fullPath = join(cleoDir, stateFile);
+        if (!existsSync(fullPath))
+            continue;
+        // Check for staged or unstaged changes
+        const diffResult = await gitCommand(['diff', '--quiet', '--', fullPath], cwd);
+        const cachedResult = await gitCommand(['diff', '--cached', '--quiet', '--', fullPath], cwd);
+        const untrackedResult = await gitCommand(['ls-files', '--others', '--exclude-standard', '--', fullPath], cwd);
+        if (!diffResult.success || !cachedResult.success) {
+            changed.push({ path: fullPath, status: 'modified' });
+        }
+        else if (untrackedResult.stdout.length > 0) {
+            changed.push({ path: fullPath, status: 'untracked' });
+        }
+    }
+    return changed;
+}
+/**
+ * Check whether a checkpoint should be performed.
+ * Evaluates: enabled, git repo, debounce elapsed, files changed.
+ * @task T4552
+ */
+export async function shouldCheckpoint(options) {
+    const force = options?.force ?? false;
+    const cwd = options?.cwd;
+    // Suppression check (even force doesn't override explicit suppression)
+    if (process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true') {
+        return false;
+    }
+    const config = await loadCheckpointConfig(cwd);
+    if (!config.enabled)
+        return false;
+    if (!(await isGitRepo(cwd)))
+        return false;
+    if (await isMergeInProgress(cwd))
+        return false;
+    if (await isDetachedHead(cwd))
+        return false;
+    if (await isRebaseInProgress(cwd))
+        return false;
+    const cleoDir = getCleoDir(cwd);
+    if (!existsSync(cleoDir))
+        return false;
+    // Check debounce (unless forced)
+    if (!force) {
+        const lastCheckpoint = await getLastCheckpointTime(cleoDir);
+        const now = Math.floor(Date.now() / 1000);
+        const elapsed = now - lastCheckpoint;
+        const debounceSeconds = config.debounceMinutes * 60;
+        if (elapsed < debounceSeconds)
+            return false;
+    }
+    // Check if any state files have changes
+    const changed = await getChangedStateFiles(cleoDir, cwd);
+    return changed.length > 0;
+}
+/**
+ * Stage .cleo/ state files and commit if conditions met.
+ * Never fatal - all git errors are suppressed.
+ * @task T4552
+ */
+export async function gitCheckpoint(trigger = 'auto', context, cwd) {
+    // Suppression check
+    if (process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true') {
+        return;
+    }
+    const force = trigger === 'manual';
+    if (!(await shouldCheckpoint({ force, cwd }))) {
+        return;
+    }
+    const config = await loadCheckpointConfig(cwd);
+    const cleoDir = getCleoDir(cwd);
+    const changed = await getChangedStateFiles(cleoDir, cwd);
+    if (changed.length === 0)
+        return;
+    // Stage changed files
+    let stagedCount = 0;
+    for (const file of changed) {
+        const result = await gitCommand(['add', file.path], cwd);
+        if (result.success)
+            stagedCount++;
+    }
+    if (stagedCount === 0)
+        return;
+    // Build commit message
+    let commitMsg = `${config.messagePrefix} ${trigger} checkpoint`;
+    if (context) {
+        commitMsg = `${config.messagePrefix} ${trigger} checkpoint (${context})`;
+    }
+    // Build commit args
+    const commitArgs = ['commit', '-m', commitMsg];
+    if (config.noVerify) {
+        commitArgs.push('--no-verify');
+    }
+    // Commit
+    const commitResult = await gitCommand(commitArgs, cwd);
+    if (!commitResult.success) {
+        // If commit failed, unstage our changes
+        for (const file of changed) {
+            await gitCommand(['reset', 'HEAD', '--', file.path], cwd);
+        }
+        return;
+    }
+    // Record checkpoint time
+    await recordCheckpointTime(cleoDir);
+}
+/**
+ * Show checkpoint configuration and status.
+ * @task T4552
+ */
+export async function gitCheckpointStatus(cwd) {
+    const config = await loadCheckpointConfig(cwd);
+    const cleoDir = getCleoDir(cwd);
+    const lastCheckpoint = await getLastCheckpointTime(cleoDir);
+    let lastCheckpointIso = 'never';
+    if (lastCheckpoint !== 0) {
+        lastCheckpointIso = new Date(lastCheckpoint * 1000).toISOString();
+    }
+    const isRepo = await isGitRepo(cwd);
+    let pendingChanges = 0;
+    if (isRepo) {
+        const changed = await getChangedStateFiles(cleoDir, cwd);
+        pendingChanges = changed.length;
+    }
+    const suppressed = process.env['GIT_CHECKPOINT_SUPPRESS'] === 'true';
+    return {
+        config,
+        status: {
+            isGitRepo: isRepo,
+            lastCheckpoint: lastCheckpointIso,
+            lastCheckpointEpoch: lastCheckpoint,
+            pendingChanges,
+            suppressed,
+        },
+    };
+}
+/**
+ * Show what files would be committed (dry-run).
+ * @task T4552
+ */
+export async function gitCheckpointDryRun(cwd) {
+    const cleoDir = getCleoDir(cwd);
+    const isRepo = await isGitRepo(cwd);
+    if (!isRepo)
+        return [];
+    return getChangedStateFiles(cleoDir, cwd);
+}
+//# sourceMappingURL=git-checkpoint.js.map

package/dist/store/git-checkpoint.js.map

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

package/dist/store/import-logging.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Import-specific logging functions for CLEO system.
+ * Ported from lib/data/import-logging.sh
+ *
+ * Provides structured audit logging for import operations including
+ * start, success, error, and conflict events.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+/** Import package metadata extracted from the export file. */
+export interface ImportPackageMeta {
+    sourceFile: string;
+    sourceProject: string;
+    exportedAt: string;
+    packageChecksum: string;
+    taskCount: number;
+}
+/** Import conflict types. */
+export type ImportConflictType = 'duplicate_title' | 'missing_dependency' | 'missing_parent' | 'depth_exceeded' | 'phase_mismatch';
+/** Import conflict resolution strategies. */
+export type ImportConflictResolution = 'skip' | 'rename' | 'force' | 'strip' | 'create_placeholder' | 'fail';
+/** Import options for logging context. */
+export interface ImportOptions {
+    parent?: string;
+    phase?: string;
+    resetStatus?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * Extract package metadata from an export file.
+ * @task T4552
+ */
+export declare function extractPackageMeta(sourceFilePath: string): Promise<ImportPackageMeta>;
+/**
+ * Log import operation start with package metadata.
+ * @task T4552
+ */
+export declare function logImportStart(sourceFilePath: string, sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import operation completion with full metadata.
+ * @task T4552
+ */
+export declare function logImportSuccess(sourceFilePath: string, tasksImported: string[], idRemap: Record<string, string>, conflicts?: Array<{
+    type: string;
+    resolution: string;
+}>, options?: ImportOptions, sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import operation error with diagnostic details.
+ * @task T4552
+ */
+export declare function logImportError(sourceFilePath: string, errorMessage: string, errorCode: string | number, stage?: 'validation' | 'parsing' | 'remapping' | 'writing' | 'unknown', sessionId?: string, cwd?: string): Promise<void>;
+/**
+ * Log import conflict detection and resolution.
+ * @task T4552
+ */
+export declare function logImportConflict(conflictType: ImportConflictType, taskId: string, conflictDetails: Record<string, unknown>, resolution: ImportConflictResolution, sessionId?: string, cwd?: string): Promise<void>;
+//# sourceMappingURL=import-logging.d.ts.map

package/dist/store/import-logging.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-logging.d.ts","sourceRoot":"","sources":["../../src/store/import-logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH,8DAA8D;AAC9D,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,6BAA6B;AAC7B,MAAM,MAAM,kBAAkB,GAC1B,iBAAiB,GACjB,oBAAoB,GACpB,gBAAgB,GAChB,gBAAgB,GAChB,gBAAgB,CAAC;AAErB,6CAA6C;AAC7C,MAAM,MAAM,wBAAwB,GAChC,MAAM,GACN,QAAQ,GACR,OAAO,GACP,OAAO,GACP,oBAAoB,GACpB,MAAM,CAAC;AAEX,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAuBD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAW5B;AA+BD;;;GAGG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAwBf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC/B,SAAS,CAAC,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,EACvD,OAAO,CAAC,EAAE,aAAa,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgCf;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,EACpB,SAAS,EAAE,MAAM,GAAG,MAAM,EAC1B,KAAK,GAAE,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAqB,EACjF,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAgBf;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,YAAY,EAAE,kBAAkB,EAChC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxC,UAAU,EAAE,wBAAwB,EACpC,SAAS,CAAC,EAAE,MAAM,EAClB,GAAG,CAAC,EAAE,MAAM,GACX,OAAO,CAAC,IAAI,CAAC,CAYf"}

package/dist/store/import-logging.js

@@ -0,0 +1,139 @@
+/**
+ * Import-specific logging functions for CLEO system.
+ * Ported from lib/data/import-logging.sh
+ *
+ * Provides structured audit logging for import operations including
+ * start, success, error, and conflict events.
+ *
+ * @task T4552
+ * @epic T4545
+ */
+import { readJson, appendJsonl } from './json.js';
+import { getLogPath } from '../core/paths.js';
+/**
+ * Generate a log entry ID.
+ * @task T4552
+ */
+function generateLogId() {
+    const epoch = Math.floor(Date.now() / 1000);
+    const rand = Math.random().toString(36).slice(2, 8);
+    return `log-${epoch}-${rand}`;
+}
+/**
+ * Extract package metadata from an export file.
+ * @task T4552
+ */
+export async function extractPackageMeta(sourceFilePath) {
+    const data = await readJson(sourceFilePath);
+    const meta = data?._meta;
+    return {
+        sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+        sourceProject: meta?.source?.project ?? 'unknown',
+        exportedAt: meta?.exportedAt ?? 'unknown',
+        packageChecksum: meta?.checksum ?? 'unknown',
+        taskCount: typeof meta?.taskCount === 'number' ? meta.taskCount : 0,
+    };
+}
+/**
+ * Write a log entry to the log file.
+ * @task T4552
+ */
+async function writeLogEntry(action, taskId, details, sessionId, cwd) {
+    const logPath = getLogPath(cwd);
+    const entry = {
+        id: generateLogId(),
+        timestamp: new Date().toISOString(),
+        action,
+        taskId,
+        actor: 'system',
+        details,
+        sessionId: sessionId ?? null,
+    };
+    try {
+        await appendJsonl(logPath, entry);
+    }
+    catch {
+        // Log failure is non-fatal
+    }
+}
+/**
+ * Log import operation start with package metadata.
+ * @task T4552
+ */
+export async function logImportStart(sourceFilePath, sessionId, cwd) {
+    let meta;
+    try {
+        meta = await extractPackageMeta(sourceFilePath);
+    }
+    catch {
+        meta = {
+            sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+            sourceProject: 'unknown',
+            exportedAt: 'unknown',
+            packageChecksum: 'unknown',
+            taskCount: 0,
+        };
+    }
+    await writeLogEntry('import', null, {
+        ...meta,
+        stage: 'start',
+    }, sessionId, cwd);
+}
+/**
+ * Log import operation completion with full metadata.
+ * @task T4552
+ */
+export async function logImportSuccess(sourceFilePath, tasksImported, idRemap, conflicts, options, sessionId, cwd) {
+    let meta;
+    try {
+        meta = await extractPackageMeta(sourceFilePath);
+    }
+    catch {
+        meta = {
+            sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+            sourceProject: 'unknown',
+            exportedAt: 'unknown',
+            packageChecksum: 'unknown',
+            taskCount: 0,
+        };
+    }
+    await writeLogEntry('import', null, {
+        sourceFile: meta.sourceFile,
+        sourceProject: meta.sourceProject,
+        exportedAt: meta.exportedAt,
+        packageChecksum: meta.packageChecksum,
+        importedAt: new Date().toISOString(),
+        tasksImported,
+        idRemap,
+        conflicts: conflicts ?? [],
+        options: options ?? {},
+        stage: 'success',
+    }, sessionId, cwd);
+}
+/**
+ * Log import operation error with diagnostic details.
+ * @task T4552
+ */
+export async function logImportError(sourceFilePath, errorMessage, errorCode, stage = 'unknown', sessionId, cwd) {
+    await writeLogEntry('error_occurred', null, {
+        sourceFile: sourceFilePath.split('/').pop() ?? sourceFilePath,
+        stage,
+        error: {
+            message: errorMessage,
+            code: String(errorCode),
+            timestamp: new Date().toISOString(),
+        },
+    }, sessionId, cwd);
+}
+/**
+ * Log import conflict detection and resolution.
+ * @task T4552
+ */
+export async function logImportConflict(conflictType, taskId, conflictDetails, resolution, sessionId, cwd) {
+    await writeLogEntry('task_updated', taskId, {
+        conflictType,
+        resolution,
+        details: conflictDetails,
+    }, sessionId, cwd);
+}
+//# sourceMappingURL=import-logging.js.map

package/dist/store/import-logging.js.map

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

package/dist/store/import-remap.d.ts

@@ -0,0 +1,50 @@
+/**
+ * ID remapping logic for import system.
+ * Ported from lib/data/import-remap.sh
+ *
+ * @epic T4454
+ * @task T4530
+ */
+import type { Task } from '../types/task.js';
+/** Forward and reverse remap tables. */
+export interface RemapTable {
+    forward: Map<string, string>;
+    reverse: Map<string, string>;
+}
+/**
+ * Get the next available task ID number from existing tasks.
+ */
+export declare function getNextAvailableId(tasks: Task[]): number;
+/**
+ * Generate a remap table for importing tasks.
+ * Maps source task IDs to new sequential IDs starting from nextAvailable.
+ */
+export declare function generateRemapTable(sourceTaskIds: string[], existingTasks: Task[]): RemapTable;
+/**
+ * Validate that a remap table is complete and consistent.
+ */
+export declare function validateRemapTable(table: RemapTable, expectedSourceIds: string[]): {
+    valid: boolean;
+    errors: string[];
+};
+/**
+ * Remap a single task ID, returning original if not in table.
+ */
+export declare function remapTaskId(taskId: string | null, table: RemapTable): string | null;
+/**
+ * Remap all ID references in a task.
+ */
+export declare function remapTaskReferences(task: Task, table: RemapTable, existingTaskIds: Set<string>, missingDepStrategy?: 'strip' | 'fail'): Task;
+/**
+ * Detect duplicate titles between import and target.
+ */
+export declare function detectDuplicateTitles(importTasks: Task[], existingTasks: Task[]): Array<{
+    sourceId: string;
+    title: string;
+    existingId: string;
+}>;
+/**
+ * Resolve duplicate title by appending suffix.
+ */
+export declare function resolveDuplicateTitle(title: string, existingTitles: Set<string>): string;
+//# sourceMappingURL=import-remap.d.ts.map

package/dist/store/import-remap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-remap.d.ts","sourceRoot":"","sources":["../../src/store/import-remap.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,wCAAwC;AACxC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,MAAM,CAOxD;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,IAAI,EAAE,GACpB,UAAU,CAaZ;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,UAAU,EACjB,iBAAiB,EAAE,MAAM,EAAE,GAC1B;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CA0BtC;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,IAAI,CAGnF;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,eAAe,EAAE,GAAG,CAAC,MAAM,CAAC,EAC5B,kBAAkB,GAAE,OAAO,GAAG,MAAgB,GAC7C,IAAI,CAsCN;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,IAAI,EAAE,EACnB,aAAa,EAAE,IAAI,EAAE,GACpB,KAAK,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAehE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,GAC1B,MAAM,CAUR"}