@cleocode/cleo 2026.4.161 → 2026.5.1

package/dist/cli/commands/gc.js

@@ -0,0 +1,165 @@
+/**
+ * CLI command: cleo gc
+ *
+ * Manual GC trigger and status reporting.
+ *
+ * Subcommands:
+ *   cleo gc run     — manual GC trigger (blocking, for debugging/immediate need)
+ *   cleo gc status  — show last run stats, disk%, escalation state
+ *
+ * The GC engine checks disk pressure on `~/.cleo/` and prunes transcripts
+ * under `~/.claude/projects/` based on the five-tier threshold model.
+ *
+ * @see packages/core/src/gc/runner.ts for GC logic
+ * @see ADR-047 — Autonomous GC and Disk Safety
+ * @task T731
+ * @epic T726
+ */
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+import { runGC } from '@cleocode/core/gc/runner.js';
+import { readGCState } from '@cleocode/core/gc/state.js';
+import { defineCommand, showUsage } from 'citty';
+/**
+ * Format a byte count into a human-readable string.
+ *
+ * @param bytes - Number of bytes
+ * @returns Human-readable string (e.g. `"1.2 GB"`, `"340 MB"`, `"0 B"`)
+ */
+function formatBytes(bytes) {
+    if (bytes === 0)
+        return '0 B';
+    const units = ['B', 'KB', 'MB', 'GB', 'TB'];
+    const exp = Math.floor(Math.log(bytes) / Math.log(1024));
+    const value = bytes / 1024 ** exp;
+    return `${value.toFixed(exp === 0 ? 0 : 1)} ${units[exp] ?? 'B'}`;
+}
+/** cleo gc run — trigger GC immediately (blocking) */
+const runCommand = defineCommand({
+    meta: {
+        name: 'run',
+        description: 'Run GC immediately (blocking). Prunes old transcripts based on disk pressure.',
+    },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Report what would be pruned without deleting anything',
+            default: false,
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        const dryRun = args['dry-run'];
+        try {
+            const gcResult = await runGC({ cleoDir, dryRun });
+            const result = { success: true, data: gcResult };
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                const dryLabel = dryRun ? ' (dry run)' : '';
+                process.stdout.write(`GC run complete${dryLabel}\n`);
+                process.stdout.write(`Disk: ${gcResult.diskUsedPct.toFixed(1)}% (${gcResult.threshold.toUpperCase()})\n`);
+                process.stdout.write(`Pruned: ${gcResult.pruned.length} paths, ${formatBytes(gcResult.bytesFreed)} freed\n`);
+                if (gcResult.escalationSet && gcResult.escalationReason) {
+                    process.stdout.write(`\nWARNING: ${gcResult.escalationReason}\n`);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const result = { success: false, error: { code: 'E_INTERNAL', message } };
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stderr.write(`GC run failed: ${message}\n`);
+            }
+            process.exit(1);
+        }
+    },
+});
+/** cleo gc status — show last GC run stats, disk usage, and escalation state */
+const statusCommand = defineCommand({
+    meta: {
+        name: 'status',
+        description: 'Show last GC run stats, disk usage, and escalation state',
+    },
+    args: {
+        'cleo-dir': {
+            type: 'string',
+            description: 'Override .cleo/ directory path',
+        },
+        json: {
+            type: 'boolean',
+            description: 'Output result as JSON',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        const cleoDir = args['cleo-dir'] ?? join(homedir(), '.cleo');
+        const statePath = join(cleoDir, 'gc-state.json');
+        try {
+            const state = await readGCState(statePath);
+            const result = { success: true, data: state };
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stdout.write(`Last run:     ${state.lastRunAt ?? 'never'}\n`);
+                process.stdout.write(`Last result:  ${state.lastRunResult ?? 'none'}\n`);
+                process.stdout.write(`Bytes freed:  ${formatBytes(state.lastRunBytesFreed)}\n`);
+                const diskStr = state.lastDiskUsedPct !== null ? `${state.lastDiskUsedPct.toFixed(1)}%` : 'unknown';
+                process.stdout.write(`Disk used:    ${diskStr}\n`);
+                process.stdout.write(`Failures:     ${state.consecutiveFailures}\n`);
+                process.stdout.write(`Escalation:   ${state.escalationNeeded ? 'YES — run cleo gc run' : 'no'}\n`);
+                if (state.escalationReason) {
+                    process.stdout.write(`Reason:       ${state.escalationReason}\n`);
+                }
+            }
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const result = { success: false, error: { code: 'E_INTERNAL', message } };
+            if (args.json) {
+                process.stdout.write(JSON.stringify(result) + '\n');
+            }
+            else {
+                process.stderr.write(`Error reading GC status: ${message}\n`);
+            }
+            process.exit(1);
+        }
+    },
+});
+/**
+ * Root GC command group — transcript garbage collection manual trigger and status.
+ *
+ * Subcommands dispatch directly to the GC runner and state reader without
+ * going through the dispatch layer (GC is a local utility, not a domain operation).
+ */
+export const gcCommand = defineCommand({
+    meta: {
+        name: 'gc',
+        description: 'Transcript garbage collection: manual trigger and status',
+    },
+    subCommands: {
+        run: runCommand,
+        status: statusCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=gc.js.map

package/dist/cli/commands/gc.js.map

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

package/dist/cli/commands/generate-changelog.d.ts

@@ -0,0 +1,30 @@
+/**
+ * CLI generate-changelog command - generate changelog from completed tasks.
+ * Supports multiple output platforms (Mintlify, Docusaurus, plain).
+ *
+ * @task T4555
+ * @epic T4545
+ */
+/**
+ * Native citty command for `cleo generate-changelog` — generates
+ * platform-specific changelog output from CHANGELOG.md source.
+ *
+ * @task T4555
+ * @epic T487
+ */
+export declare const generateChangelogCommand: import("citty").CommandDef<{
+    readonly platform: {
+        readonly type: "string";
+        readonly description: "Target platform (mintlify, docusaurus, plain, github)";
+    };
+    readonly limit: {
+        readonly type: "string";
+        readonly description: "Max versions to include";
+        readonly default: "15";
+    };
+    readonly 'dry-run': {
+        readonly type: "boolean";
+        readonly description: "Show what would be generated without writing";
+    };
+}>;
+//# sourceMappingURL=generate-changelog.d.ts.map

package/dist/cli/commands/generate-changelog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-changelog.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/generate-changelog.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA8MH;;;;;;GAMG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;EA+FnC,CAAC"}

package/dist/cli/commands/generate-changelog.js

@@ -0,0 +1,270 @@
+/**
+ * CLI generate-changelog command - generate changelog from completed tasks.
+ * Supports multiple output platforms (Mintlify, Docusaurus, plain).
+ *
+ * @task T4555
+ * @epic T4545
+ */
+import { execFileSync } from 'node:child_process';
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { ExitCode } from '@cleocode/contracts';
+import { CleoError, formatError, getConfigPath, getProjectRoot } from '@cleocode/core';
+import { defineCommand } from 'citty';
+// CLI-only: implements local file generation from CHANGELOG.md, not a dispatch operation
+import { cliOutput } from '../renderers/index.js';
+/**
+ * Get changelog source path from config.
+ * @task T4555
+ */
+function getChangelogSource(cwd) {
+    const configPath = getConfigPath(cwd);
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        return config?.release?.changelog?.source ?? 'CHANGELOG.md';
+    }
+    catch {
+        return 'CHANGELOG.md';
+    }
+}
+/**
+ * Get enabled output platforms from config.
+ * @task T4555
+ */
+function getEnabledPlatforms(cwd) {
+    const configPath = getConfigPath(cwd);
+    try {
+        const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+        const outputs = config?.release?.changelog?.outputs ?? [];
+        return outputs.filter((o) => o.enabled);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Get default output path for a platform.
+ * @task T4555
+ */
+function getDefaultOutputPath(platform) {
+    switch (platform) {
+        case 'mintlify':
+            return 'docs/changelog/overview.mdx';
+        case 'docusaurus':
+            return 'docs/changelog.md';
+        default:
+            return 'CHANGELOG.md';
+    }
+}
+/**
+ * Get GitHub repo slug from git remote using execFileSync (no shell injection).
+ * @task T4555
+ */
+function getGitHubRepoSlug(cwd) {
+    const projectRoot = getProjectRoot(cwd);
+    try {
+        const remoteUrl = execFileSync('git', ['remote', 'get-url', 'origin'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return remoteUrl.replace(/.*github\.com[:/]/, '').replace(/\.git$/, '');
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Generate changelog for a specific platform using CHANGELOG.md as source.
+ * @task T4555
+ */
+function generateForPlatform(platform, sourceContent, repoSlug, limit) {
+    switch (platform) {
+        case 'mintlify':
+            return generateMintlify(sourceContent, repoSlug, limit);
+        case 'docusaurus':
+            return generateDocusaurus(sourceContent, limit);
+        default:
+            return sourceContent;
+    }
+}
+/**
+ * Generate Mintlify MDX changelog format.
+ * @task T4555
+ */
+function generateMintlify(source, repoSlug, limit) {
+    const lines = [];
+    lines.push('---');
+    lines.push('title: "Changelog"');
+    lines.push('description: "CLEO release history and product updates"');
+    lines.push('icon: "clock-rotate-left"');
+    lines.push('rss: true');
+    lines.push('---');
+    lines.push('');
+    lines.push('# Changelog');
+    lines.push('');
+    // Parse version blocks from source
+    const sourceLines = source.split('\n');
+    const blocks = [];
+    let currentBlock = null;
+    for (let i = 0; i < sourceLines.length; i++) {
+        const line = sourceLines[i];
+        const vMatch = line.match(/^## \[v?(\d+\.\d+\.\d+)\] - (\d{4}-\d{2}-\d{2})/);
+        if (vMatch) {
+            if (currentBlock) {
+                blocks.push({
+                    version: currentBlock.version,
+                    date: currentBlock.date,
+                    content: sourceLines
+                        .slice(currentBlock.startLine + 1, i)
+                        .join('\n')
+                        .trim(),
+                });
+            }
+            currentBlock = { version: vMatch[1], date: vMatch[2], startLine: i };
+        }
+    }
+    if (currentBlock) {
+        blocks.push({
+            version: currentBlock.version,
+            date: currentBlock.date,
+            content: sourceLines
+                .slice(currentBlock.startLine + 1)
+                .join('\n')
+                .trim(),
+        });
+    }
+    for (const block of blocks.slice(0, limit)) {
+        lines.push(`## v${block.version} - ${block.date}`);
+        lines.push('');
+        lines.push(block.content);
+        lines.push('');
+        if (repoSlug) {
+            lines.push(`[View full release notes](https://github.com/${repoSlug}/releases/tag/v${block.version})`);
+            lines.push('');
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Generate Docusaurus markdown changelog format.
+ * @task T4555
+ */
+function generateDocusaurus(source, limit) {
+    const lines = [];
+    lines.push('---');
+    lines.push('id: changelog');
+    lines.push('title: Changelog');
+    lines.push('sidebar_label: Changelog');
+    lines.push('---');
+    lines.push('');
+    lines.push('# Changelog');
+    lines.push('');
+    const sourceLines = source.split('\n');
+    let versionCount = 0;
+    let inUnreleased = false;
+    for (const line of sourceLines) {
+        if (/^## \[Unreleased\]/.test(line)) {
+            inUnreleased = true;
+            continue;
+        }
+        if (/^## \[v?\d+\.\d+\.\d+\]/.test(line)) {
+            inUnreleased = false;
+            versionCount++;
+            if (versionCount > limit)
+                break;
+        }
+        if (!inUnreleased && versionCount > 0) {
+            lines.push(line);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Native citty command for `cleo generate-changelog` — generates
+ * platform-specific changelog output from CHANGELOG.md source.
+ *
+ * @task T4555
+ * @epic T487
+ */
+export const generateChangelogCommand = defineCommand({
+    meta: {
+        name: 'generate-changelog',
+        description: 'Generate platform-specific changelog from CHANGELOG.md',
+    },
+    args: {
+        platform: {
+            type: 'string',
+            description: 'Target platform (mintlify, docusaurus, plain, github)',
+        },
+        limit: {
+            type: 'string',
+            description: 'Max versions to include',
+            default: '15',
+        },
+        'dry-run': {
+            type: 'boolean',
+            description: 'Show what would be generated without writing',
+        },
+    },
+    async run({ args }) {
+        try {
+            const limit = Number(args.limit ?? 15);
+            const targetPlatform = args.platform;
+            const dryRun = args['dry-run'] === true;
+            const sourceFile = getChangelogSource();
+            const sourcePath = join(getProjectRoot(), sourceFile);
+            if (!existsSync(sourcePath)) {
+                throw new CleoError(ExitCode.NOT_FOUND, `Changelog source not found: ${sourcePath}`);
+            }
+            const sourceContent = readFileSync(sourcePath, 'utf-8');
+            const repoSlug = getGitHubRepoSlug();
+            const results = [];
+            if (targetPlatform) {
+                const platforms = getEnabledPlatforms();
+                const platformConfig = platforms.find((p) => p.platform === targetPlatform);
+                const outputPath = platformConfig?.path ?? getDefaultOutputPath(targetPlatform);
+                const content = generateForPlatform(targetPlatform, sourceContent, repoSlug, limit);
+                if (!dryRun) {
+                    const fullPath = join(getProjectRoot(), outputPath);
+                    mkdirSync(dirname(fullPath), { recursive: true });
+                    writeFileSync(fullPath, content, 'utf-8');
+                }
+                results.push({ platform: targetPlatform, path: outputPath, written: !dryRun });
+            }
+            else {
+                const platforms = getEnabledPlatforms();
+                if (platforms.length === 0) {
+                    throw new CleoError(ExitCode.CONFIG_ERROR, 'No changelog output platforms configured. Configure in .cleo/config.json under release.changelog.outputs');
+                }
+                for (const platformConfig of platforms) {
+                    const content = generateForPlatform(platformConfig.platform, sourceContent, repoSlug, limit);
+                    if (!dryRun) {
+                        const fullPath = join(getProjectRoot(), platformConfig.path);
+                        mkdirSync(dirname(fullPath), { recursive: true });
+                        writeFileSync(fullPath, content, 'utf-8');
+                    }
+                    results.push({
+                        platform: platformConfig.platform,
+                        path: platformConfig.path,
+                        written: !dryRun,
+                    });
+                }
+            }
+            cliOutput({
+                dryRun,
+                source: sourceFile,
+                repoSlug: repoSlug || null,
+                generated: results,
+            }, { command: 'generate-changelog' });
+        }
+        catch (err) {
+            if (err instanceof CleoError) {
+                console.error(formatError(err));
+                process.exit(err.code);
+            }
+            throw err;
+        }
+    },
+});
+//# sourceMappingURL=generate-changelog.js.map

package/dist/cli/commands/generate-changelog.js.map

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

package/dist/cli/commands/grade.d.ts

@@ -0,0 +1,13 @@
+/** Native citty command for `cleo grade [sessionId]`. */
+export declare const gradeCommand: import("citty").CommandDef<{
+    readonly sessionId: {
+        readonly type: "positional";
+        readonly description: "Session ID to grade";
+        readonly required: false;
+    };
+    readonly list: {
+        readonly type: "boolean";
+        readonly description: "List all past grade results";
+    };
+}>;
+//# sourceMappingURL=grade.d.ts.map

package/dist/cli/commands/grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/grade.ts"],"names":[],"mappings":"AAOA,yDAAyD;AACzD,eAAO,MAAM,YAAY;;;;;;;;;;EAsBvB,CAAC"}

package/dist/cli/commands/grade.js

@@ -0,0 +1,27 @@
+/**
+ * Grade command
+ * @task T4916
+ * @task T487
+ */
+import { defineCommand } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** Native citty command for `cleo grade [sessionId]`. */
+export const gradeCommand = defineCommand({
+    meta: {
+        name: 'grade',
+        description: 'Grade agent behavior for a session (requires --grade flag on session start)',
+    },
+    args: {
+        sessionId: { type: 'positional', description: 'Session ID to grade', required: false },
+        list: { type: 'boolean', description: 'List all past grade results' },
+    },
+    async run({ args }) {
+        if (args.list || !args.sessionId) {
+            await dispatchFromCli('query', 'check', 'grade.list', {}, { command: 'grade' });
+        }
+        else {
+            await dispatchFromCli('query', 'check', 'grade', { sessionId: args.sessionId }, { command: 'grade' });
+        }
+    },
+});
+//# sourceMappingURL=grade.js.map

package/dist/cli/commands/grade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.js","sourceRoot":"","sources":["../../../src/cli/commands/grade.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,yDAAyD;AACzD,MAAM,CAAC,MAAM,YAAY,GAAG,aAAa,CAAC;IACxC,IAAI,EAAE;QACJ,IAAI,EAAE,OAAO;QACb,WAAW,EAAE,6EAA6E;KAC3F;IACD,IAAI,EAAE;QACJ,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,QAAQ,EAAE,KAAK,EAAE;QACtF,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;KACtE;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;YACjC,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC;QAClF,CAAC;aAAM,CAAC;YACN,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,OAAO,EACP,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,EAC7B,EAAE,OAAO,EAAE,OAAO,EAAE,CACrB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC,CAAC"}

package/dist/cli/commands/history.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CLI history command - completion timeline, audit log, and task work history.
+ * @task T4538
+ * @epic T4454
+ * @task T5323
+ */
+/**
+ * Root history command group — completion timeline and productivity analytics.
+ *
+ * Dispatches to `admin.log` (audit log) and `tasks.history` (work history).
+ */
+export declare const historyCommand: import("citty").CommandDef<import("citty").ArgsDef>;
+//# sourceMappingURL=history.d.ts.map

package/dist/cli/commands/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAmDH;;;;GAIG;AACH,eAAO,MAAM,cAAc,qDAWzB,CAAC"}

package/dist/cli/commands/history.js

@@ -0,0 +1,65 @@
+/**
+ * CLI history command - completion timeline, audit log, and task work history.
+ * @task T4538
+ * @epic T4454
+ * @task T5323
+ */
+import { defineCommand, showUsage } from 'citty';
+import { dispatchFromCli } from '../../dispatch/adapters/cli.js';
+/** cleo history log — show operation audit log with optional date range */
+const logCommand = defineCommand({
+    meta: { name: 'log', description: 'Show operation audit log' },
+    args: {
+        days: {
+            type: 'string',
+            description: 'Show last N days',
+            default: '30',
+        },
+        since: {
+            type: 'string',
+            description: 'Show completions since date (YYYY-MM-DD)',
+        },
+        until: {
+            type: 'string',
+            description: 'Show completions until date (YYYY-MM-DD)',
+        },
+        'no-chart': {
+            type: 'boolean',
+            description: 'Disable bar charts',
+            default: false,
+        },
+    },
+    async run({ args }) {
+        await dispatchFromCli('query', 'admin', 'log', {
+            days: Number.parseInt(args.days, 10),
+            since: args.since,
+            until: args.until,
+        }, { command: 'history' });
+    },
+});
+/** cleo history work — show time tracked per task */
+const workCommand = defineCommand({
+    meta: { name: 'work', description: 'Show task work history (time tracked per task)' },
+    async run() {
+        await dispatchFromCli('query', 'tasks', 'history', {}, { command: 'history' });
+    },
+});
+/**
+ * Root history command group — completion timeline and productivity analytics.
+ *
+ * Dispatches to `admin.log` (audit log) and `tasks.history` (work history).
+ */
+export const historyCommand = defineCommand({
+    meta: { name: 'history', description: 'Completion timeline and productivity analytics' },
+    subCommands: {
+        log: logCommand,
+        work: workCommand,
+    },
+    async run({ cmd, rawArgs }) {
+        const firstArg = rawArgs?.find((a) => !a.startsWith('-'));
+        if (firstArg && cmd.subCommands && firstArg in cmd.subCommands)
+            return;
+        await showUsage(cmd);
+    },
+});
+//# sourceMappingURL=history.js.map

package/dist/cli/commands/history.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.js","sourceRoot":"","sources":["../../../src/cli/commands/history.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACjD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AAEjE,2EAA2E;AAC3E,MAAM,UAAU,GAAG,aAAa,CAAC;IAC/B,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,0BAA0B,EAAE;IAC9D,IAAI,EAAE;QACJ,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE,IAAI;SACd;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SACxD;QACD,KAAK,EAAE;YACL,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,0CAA0C;SACxD;QACD,UAAU,EAAE;YACV,IAAI,EAAE,SAAS;YACf,WAAW,EAAE,oBAAoB;YACjC,OAAO,EAAE,KAAK;SACf;KACF;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE;QAChB,MAAM,eAAe,CACnB,OAAO,EACP,OAAO,EACP,KAAK,EACL;YACE,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,KAAK,EAAE,IAAI,CAAC,KAA2B;YACvC,KAAK,EAAE,IAAI,CAAC,KAA2B;SACxC,EACD,EAAE,OAAO,EAAE,SAAS,EAAE,CACvB,CAAC;IACJ,CAAC;CACF,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,WAAW,GAAG,aAAa,CAAC;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACrF,KAAK,CAAC,GAAG;QACP,MAAM,eAAe,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IACjF,CAAC;CACF,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;IAC1C,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,gDAAgD,EAAE;IACxF,WAAW,EAAE;QACX,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,WAAW;KAClB;IACD,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,OAAO,EAAE;QACxB,MAAM,QAAQ,GAAG,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW,IAAI,QAAQ,IAAI,GAAG,CAAC,WAAW;YAAE,OAAO;QACvE,MAAM,SAAS,CAAC,GAAG,CAAC,CAAC;IACvB,CAAC;CACF,CAAC,CAAC"}