@cleocode/cleo 2026.2.5

package/dist/core/nexus/deps.js

@@ -0,0 +1,394 @@
+/**
+ * NEXUS dependency analysis - global dependency graph across projects.
+ *
+ * Builds a unified graph of all tasks and cross-project edges,
+ * supporting forward/reverse dependency lookups, critical path analysis,
+ * blocking impact analysis, and orphan detection.
+ *
+ * @task T4574
+ * @epic T4540
+ */
+import { join } from 'node:path';
+import { readFile } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { z } from 'zod';
+import { CleoError } from '../errors.js';
+import { ExitCode } from '../../types/exit-codes.js';
+import { readRegistryRequired } from './registry.js';
+import { parseQuery, validateSyntax, resolveTask } from './query.js';
+import { checkPermission } from './permissions.js';
+// ── Schemas ──────────────────────────────────────────────────────────
+export const NexusGraphNodeSchema = z.object({
+    id: z.string(),
+    project: z.string(),
+    status: z.string(),
+    title: z.string(),
+});
+export const NexusGraphEdgeSchema = z.object({
+    from: z.string(),
+    fromProject: z.string(),
+    to: z.string(),
+    toProject: z.string(),
+});
+export const NexusGlobalGraphSchema = z.object({
+    nodes: z.array(NexusGraphNodeSchema),
+    edges: z.array(NexusGraphEdgeSchema),
+});
+// ── Graph cache ──────────────────────────────────────────────────────
+let cachedGraph = null;
+let cachedChecksum = null;
+/** Invalidate the in-memory graph cache. */
+export function invalidateGraphCache() {
+    cachedGraph = null;
+    cachedChecksum = null;
+}
+// ── Graph building ───────────────────────────────────────────────────
+/** Cross-project reference pattern: `project-name:T001`. */
+const CROSS_REF_RE = /^([a-z0-9_-]+):(.+)$/;
+/** Read tasks from a project path, returning empty array on failure. */
+async function readProjectTasks(projectPath) {
+    try {
+        const todoPath = join(projectPath, '.cleo', 'todo.json');
+        const raw = await readFile(todoPath, 'utf-8');
+        const data = JSON.parse(raw);
+        return data.tasks ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/** Compute a checksum across all registered project todo.json files. */
+async function computeGlobalChecksum(registry) {
+    const hash = createHash('sha256');
+    for (const project of Object.values(registry.projects)) {
+        try {
+            const todoPath = join(project.path, '.cleo', 'todo.json');
+            const content = await readFile(todoPath, 'utf-8');
+            hash.update(content);
+        }
+        catch {
+            // Skip unreadable projects
+        }
+    }
+    return hash.digest('hex').substring(0, 16);
+}
+/**
+ * Build the global dependency graph from all registered projects.
+ * Uses checksum-based caching to avoid unnecessary rebuilds.
+ */
+export async function buildGlobalGraph() {
+    const registry = await readRegistryRequired();
+    const checksum = await computeGlobalChecksum(registry);
+    // Return cached if valid
+    if (cachedGraph && cachedChecksum === checksum) {
+        return cachedGraph;
+    }
+    const nodes = [];
+    const edges = [];
+    for (const project of Object.values(registry.projects)) {
+        // Check read permission
+        if (!(await checkPermission(project.name, 'read'))) {
+            continue;
+        }
+        const tasks = await readProjectTasks(project.path);
+        // Add nodes
+        for (const task of tasks) {
+            nodes.push({
+                id: task.id,
+                project: project.name,
+                status: task.status,
+                title: task.title,
+            });
+        }
+        // Add edges from dependencies
+        for (const task of tasks) {
+            if (!task.depends || task.depends.length === 0)
+                continue;
+            for (const dep of task.depends) {
+                const match = CROSS_REF_RE.exec(dep);
+                if (match) {
+                    // Cross-project dependency
+                    edges.push({
+                        from: task.id,
+                        fromProject: project.name,
+                        to: match[2],
+                        toProject: match[1],
+                    });
+                }
+                else {
+                    // Same-project dependency
+                    edges.push({
+                        from: task.id,
+                        fromProject: project.name,
+                        to: dep,
+                        toProject: project.name,
+                    });
+                }
+            }
+        }
+    }
+    const graph = { nodes, edges };
+    cachedGraph = graph;
+    cachedChecksum = checksum;
+    return graph;
+}
+// ── Dependency queries ───────────────────────────────────────────────
+/**
+ * Show dependencies for a task across projects.
+ * Supports forward (what this depends on) and reverse (what depends on this) lookups.
+ */
+export async function nexusDeps(taskQuery, direction = 'forward') {
+    if (!validateSyntax(taskQuery)) {
+        throw new CleoError(ExitCode.NEXUS_INVALID_SYNTAX, `Invalid query syntax: ${taskQuery}`);
+    }
+    const parsed = parseQuery(taskQuery);
+    // Check read permission
+    if (!(await checkPermission(parsed.project, 'read'))) {
+        throw new CleoError(ExitCode.NEXUS_PERMISSION_DENIED, `Read permission required for project '${parsed.project}'`);
+    }
+    // Resolve the task
+    const task = await resolveTask(taskQuery);
+    if (Array.isArray(task)) {
+        throw new CleoError(ExitCode.NEXUS_QUERY_FAILED, 'Wildcard queries not supported for dependency analysis');
+    }
+    const graph = await buildGlobalGraph();
+    const result = {
+        task: taskQuery,
+        project: parsed.project,
+        depends: [],
+        blocking: [],
+    };
+    if (direction === 'reverse') {
+        // Find what depends on this task
+        const dependents = graph.edges.filter(e => e.to === parsed.taskId && e.toProject === parsed.project);
+        for (const edge of dependents) {
+            const entry = {
+                query: `${edge.fromProject}:${edge.from}`,
+                project: edge.fromProject,
+                status: 'unknown',
+            };
+            try {
+                const depTask = await resolveTask(entry.query);
+                if (!Array.isArray(depTask)) {
+                    entry.status = depTask.status;
+                    entry.title = depTask.title;
+                }
+            }
+            catch {
+                entry.status = 'not_found';
+            }
+            result.blocking.push(entry);
+        }
+    }
+    else {
+        // Forward: what this task depends on
+        const deps = task.depends ?? [];
+        for (const dep of deps) {
+            const match = CROSS_REF_RE.exec(dep);
+            const depProject = match ? match[1] : parsed.project;
+            const depTaskId = match ? match[2] : dep;
+            const depQuery = `${depProject}:${depTaskId}`;
+            const entry = {
+                query: depQuery,
+                project: depProject,
+                status: 'unknown',
+            };
+            // Check permission before resolving
+            if (!(await checkPermission(depProject, 'read'))) {
+                entry.status = 'permission_denied';
+                result.depends.push(entry);
+                continue;
+            }
+            try {
+                const depTask = await resolveTask(depQuery);
+                if (!Array.isArray(depTask)) {
+                    entry.status = depTask.status;
+                    entry.title = depTask.title;
+                }
+            }
+            catch {
+                entry.status = 'not_found';
+            }
+            result.depends.push(entry);
+        }
+    }
+    return result;
+}
+/**
+ * Resolve an array of dependencies (local or cross-project).
+ */
+export async function resolveCrossDeps(depsArray, sourceProject) {
+    const resolved = [];
+    for (const dep of depsArray) {
+        const match = CROSS_REF_RE.exec(dep);
+        const depProject = match ? match[1] : sourceProject;
+        const depTaskId = match ? match[2] : dep;
+        const depQuery = `${depProject}:${depTaskId}`;
+        const entry = {
+            query: depQuery,
+            project: depProject,
+            status: 'unknown',
+        };
+        if (!(await checkPermission(depProject, 'read'))) {
+            entry.status = 'permission_denied';
+            resolved.push(entry);
+            continue;
+        }
+        try {
+            const resolvedTask = await resolveTask(depQuery);
+            if (!Array.isArray(resolvedTask)) {
+                entry.status = resolvedTask.status;
+                entry.title = resolvedTask.title;
+            }
+        }
+        catch {
+            entry.status = 'not_found';
+        }
+        resolved.push(entry);
+    }
+    return resolved;
+}
+/**
+ * Calculate the critical path across project boundaries.
+ * Returns the longest dependency chain in the global graph.
+ */
+export async function criticalPath() {
+    const graph = await buildGlobalGraph();
+    // Find all leaf nodes (no outgoing dependency edges)
+    const nodesWithOutgoing = new Set(graph.edges.map(e => `${e.fromProject}:${e.from}`));
+    const allNodeKeys = graph.nodes.map(n => `${n.project}:${n.id}`);
+    const leaves = allNodeKeys.filter(k => !nodesWithOutgoing.has(k));
+    let longestPath = [];
+    let maxLength = 0;
+    for (const leafKey of leaves) {
+        const colonIdx = leafKey.indexOf(':');
+        const project = leafKey.substring(0, colonIdx);
+        const id = leafKey.substring(colonIdx + 1);
+        const path = traceBack(graph, id, project, new Set());
+        if (path.length > maxLength) {
+            maxLength = path.length;
+            longestPath = path.reverse().map(n => ({
+                query: `${n.project}:${n.id}`,
+                title: n.title,
+            }));
+        }
+    }
+    // Find first blocker (pending/blocked task in path)
+    let blockedBy = '';
+    for (const item of longestPath) {
+        try {
+            const resolvedTask = await resolveTask(item.query);
+            if (!Array.isArray(resolvedTask) && (resolvedTask.status === 'pending' || resolvedTask.status === 'blocked')) {
+                blockedBy = item.query;
+                break;
+            }
+        }
+        catch {
+            // Skip unresolvable tasks
+        }
+    }
+    return { criticalPath: longestPath, length: maxLength, blockedBy };
+}
+/** Trace back from a node following dependency edges (DFS). */
+function traceBack(graph, taskId, project, visited) {
+    const key = `${project}:${taskId}`;
+    if (visited.has(key))
+        return [];
+    visited.add(key);
+    const node = graph.nodes.find(n => n.id === taskId && n.project === project);
+    if (!node)
+        return [];
+    // Find dependencies (edges where this task is the source)
+    const deps = graph.edges.filter(e => e.from === taskId && e.fromProject === project);
+    let longestSubpath = [];
+    for (const dep of deps) {
+        const subpath = traceBack(graph, dep.to, dep.toProject, visited);
+        if (subpath.length > longestSubpath.length) {
+            longestSubpath = subpath;
+        }
+    }
+    return [node, ...longestSubpath];
+}
+/**
+ * Analyze the blocking impact of a task across all projects.
+ * Uses BFS to find all direct and transitive dependents.
+ */
+export async function blockingAnalysis(taskQuery) {
+    if (!validateSyntax(taskQuery)) {
+        throw new CleoError(ExitCode.NEXUS_INVALID_SYNTAX, `Invalid query syntax: ${taskQuery}`);
+    }
+    const parsed = parseQuery(taskQuery);
+    const graph = await buildGlobalGraph();
+    // BFS to find all dependents
+    const allDependents = [];
+    const visited = new Set([`${parsed.project}:${parsed.taskId}`]);
+    const queue = [
+        { id: parsed.taskId, project: parsed.project },
+    ];
+    while (queue.length > 0) {
+        const current = queue.shift();
+        // Find edges where current task is a dependency target (others depend on it)
+        const dependents = graph.edges.filter(e => e.to === current.id && e.toProject === current.project);
+        for (const dep of dependents) {
+            const key = `${dep.fromProject}:${dep.from}`;
+            if (visited.has(key))
+                continue;
+            visited.add(key);
+            const depEntry = { query: key, project: dep.fromProject };
+            allDependents.push(depEntry);
+            queue.push({ id: dep.from, project: dep.fromProject });
+        }
+    }
+    return {
+        task: taskQuery,
+        blocking: allDependents,
+        impactScore: allDependents.length,
+    };
+}
+/**
+ * Detect orphaned cross-project dependencies.
+ * Finds tasks with dependency references to projects or tasks that don't exist.
+ */
+export async function orphanDetection() {
+    const registry = await readRegistryRequired();
+    const orphans = [];
+    for (const project of Object.values(registry.projects)) {
+        const tasks = await readProjectTasks(project.path);
+        for (const task of tasks) {
+            if (!task.depends || task.depends.length === 0)
+                continue;
+            for (const dep of task.depends) {
+                const match = CROSS_REF_RE.exec(dep);
+                if (!match)
+                    continue; // Only check cross-project refs
+                const targetProject = match[1];
+                const targetTask = match[2];
+                // Check if target project exists
+                const targetEntry = Object.values(registry.projects).find(p => p.name === targetProject);
+                if (!targetEntry) {
+                    orphans.push({
+                        sourceProject: project.name,
+                        sourceTask: task.id,
+                        targetProject,
+                        targetTask,
+                        reason: 'project_not_registered',
+                    });
+                    continue;
+                }
+                // Check if target task exists
+                const targetTasks = await readProjectTasks(targetEntry.path);
+                if (!targetTasks.find(t => t.id === targetTask)) {
+                    orphans.push({
+                        sourceProject: project.name,
+                        sourceTask: task.id,
+                        targetProject,
+                        targetTask,
+                        reason: 'task_not_found',
+                    });
+                }
+            }
+        }
+    }
+    return orphans;
+}
+//# sourceMappingURL=deps.js.map

package/dist/core/nexus/deps.js.map

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

package/dist/core/nexus/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * NEXUS - Cross-project intelligence system for CLEO.
+ *
+ * Provides project registration, permission enforcement,
+ * cross-project query resolution, and global dependency analysis.
+ *
+ * @task T4574
+ * @epic T4540
+ */
+export { NexusPermissionLevelSchema, NexusHealthStatusSchema, NexusProjectSchema, NexusRegistryFileSchema, type NexusPermissionLevel, type NexusHealthStatus, type NexusProject, type NexusRegistryFile, getNexusHome, getNexusCacheDir, getRegistryPath, generateProjectHash, readRegistry, readRegistryRequired, nexusInit, nexusRegister, nexusUnregister, nexusList, nexusGetProject, nexusProjectExists, nexusSync, nexusSyncAll, } from './registry.js';
+export { PermissionLevelSchema, PermissionCheckResultSchema, type PermissionCheckResult, permissionLevel, getPermission, setPermission, checkPermission, requirePermission, checkPermissionDetail, canRead, canWrite, canExecute, } from './permissions.js';
+export { NexusParsedQuerySchema, type NexusParsedQuery, type NexusResolvedTask, validateSyntax, parseQuery, getCurrentProject, resolveProjectPath, resolveTask, getProjectFromQuery, } from './query.js';
+export { NexusGraphNodeSchema, NexusGraphEdgeSchema, NexusGlobalGraphSchema, type NexusGraphNode, type NexusGraphEdge, type NexusGlobalGraph, type DepsResult, type DepsEntry, type CriticalPathResult, type BlockingAnalysisResult, type OrphanEntry, invalidateGraphCache, buildGlobalGraph, nexusDeps, resolveCrossDeps, criticalPath, blockingAnalysis, orphanDetection, } from './deps.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/core/nexus/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/core/nexus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAEL,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,EACvB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EAEtB,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EAEnB,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,eAAe,EACf,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAGvB,OAAO,EAEL,qBAAqB,EACrB,2BAA2B,EAC3B,KAAK,qBAAqB,EAE1B,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,OAAO,EACP,QAAQ,EACR,UAAU,GACX,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EAEL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,iBAAiB,EAEtB,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAEL,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB,EACtB,KAAK,cAAc,EACnB,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EACf,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAEhB,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/dist/core/nexus/index.js

@@ -0,0 +1,36 @@
+/**
+ * NEXUS - Cross-project intelligence system for CLEO.
+ *
+ * Provides project registration, permission enforcement,
+ * cross-project query resolution, and global dependency analysis.
+ *
+ * @task T4574
+ * @epic T4540
+ */
+// Registry - project registration and management
+export { 
+// Types & schemas
+NexusPermissionLevelSchema, NexusHealthStatusSchema, NexusProjectSchema, NexusRegistryFileSchema, 
+// Path helpers
+getNexusHome, getNexusCacheDir, getRegistryPath, generateProjectHash, 
+// Operations
+readRegistry, readRegistryRequired, nexusInit, nexusRegister, nexusUnregister, nexusList, nexusGetProject, nexusProjectExists, nexusSync, nexusSyncAll, } from './registry.js';
+// Permissions - three-tier access control
+export { 
+// Types & schemas
+PermissionLevelSchema, PermissionCheckResultSchema, 
+// Operations
+permissionLevel, getPermission, setPermission, checkPermission, requirePermission, checkPermissionDetail, canRead, canWrite, canExecute, } from './permissions.js';
+// Query - cross-project task resolution
+export { 
+// Types & schemas
+NexusParsedQuerySchema, 
+// Operations
+validateSyntax, parseQuery, getCurrentProject, resolveProjectPath, resolveTask, getProjectFromQuery, } from './query.js';
+// Deps - global dependency graph and analysis
+export { 
+// Types & schemas
+NexusGraphNodeSchema, NexusGraphEdgeSchema, NexusGlobalGraphSchema, 
+// Operations
+invalidateGraphCache, buildGlobalGraph, nexusDeps, resolveCrossDeps, criticalPath, blockingAnalysis, orphanDetection, } from './deps.js';
+//# sourceMappingURL=index.js.map

package/dist/core/nexus/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/core/nexus/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,iDAAiD;AACjD,OAAO;AACL,kBAAkB;AAClB,0BAA0B,EAC1B,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB;AAKvB,eAAe;AACf,YAAY,EACZ,gBAAgB,EAChB,eAAe,EACf,mBAAmB;AACnB,aAAa;AACb,YAAY,EACZ,oBAAoB,EACpB,SAAS,EACT,aAAa,EACb,eAAe,EACf,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,SAAS,EACT,YAAY,GACb,MAAM,eAAe,CAAC;AAEvB,0CAA0C;AAC1C,OAAO;AACL,kBAAkB;AAClB,qBAAqB,EACrB,2BAA2B;AAE3B,aAAa;AACb,eAAe,EACf,aAAa,EACb,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,qBAAqB,EACrB,OAAO,EACP,QAAQ,EACR,UAAU,GACX,MAAM,kBAAkB,CAAC;AAE1B,wCAAwC;AACxC,OAAO;AACL,kBAAkB;AAClB,sBAAsB;AAGtB,aAAa;AACb,cAAc,EACd,UAAU,EACV,iBAAiB,EACjB,kBAAkB,EAClB,WAAW,EACX,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,8CAA8C;AAC9C,OAAO;AACL,kBAAkB;AAClB,oBAAoB,EACpB,oBAAoB,EACpB,sBAAsB;AAStB,aAAa;AACb,oBAAoB,EACpB,gBAAgB,EAChB,SAAS,EACT,gBAAgB,EAChB,YAAY,EACZ,gBAAgB,EAChB,eAAe,GAChB,MAAM,WAAW,CAAC"}

package/dist/core/nexus/permissions.d.ts

@@ -0,0 +1,75 @@
+/**
+ * NEXUS permission enforcement - three-tier access control for cross-project operations.
+ *
+ * Permission model:
+ *   read (1)    - Query tasks, discover relationships
+ *   write (2)   - read + modify task fields, add relationships
+ *   execute (3) - write + create/delete tasks, run commands
+ *
+ * Hierarchical: execute includes write includes read.
+ * Same-project operations always have full permissions.
+ *
+ * @task T4574
+ * @epic T4540
+ */
+import { z } from 'zod';
+import { type NexusPermissionLevel } from './registry.js';
+export declare const PermissionLevelSchema: z.ZodEnum<{
+    execute: "execute";
+    read: "read";
+    write: "write";
+}>;
+export declare const PermissionCheckResultSchema: z.ZodObject<{
+    project: z.ZodString;
+    required: z.ZodEnum<{
+        execute: "execute";
+        read: "read";
+        write: "write";
+    }>;
+    granted: z.ZodEnum<{
+        execute: "execute";
+        read: "read";
+        write: "write";
+    }>;
+    allowed: z.ZodBoolean;
+}, z.core.$strip>;
+export type PermissionCheckResult = z.infer<typeof PermissionCheckResultSchema>;
+/**
+ * Convert a permission string to its numeric level.
+ * Returns 0 for invalid/unknown permissions.
+ */
+export declare function permissionLevel(permission: string): number;
+/**
+ * Get the permission level for a registered project.
+ * Returns 'read' as default if the project has no explicit permission.
+ */
+export declare function getPermission(nameOrHash: string): Promise<NexusPermissionLevel>;
+/**
+ * Check if a project has sufficient permissions (non-throwing).
+ * Uses hierarchical comparison: execute >= write >= read.
+ *
+ * @returns true if the granted permission meets or exceeds the required level.
+ */
+export declare function checkPermission(nameOrHash: string, required: NexusPermissionLevel): Promise<boolean>;
+/**
+ * Require a permission level or throw CleoError.
+ * Used as a guard at the start of cross-project operations.
+ */
+export declare function requirePermission(nameOrHash: string, required: NexusPermissionLevel, operationName?: string): Promise<void>;
+/**
+ * Full permission check returning a structured result.
+ */
+export declare function checkPermissionDetail(nameOrHash: string, required: NexusPermissionLevel): Promise<PermissionCheckResult>;
+/**
+ * Set the permission level for a project.
+ * Validates the permission value and updates the registry.
+ * @task T4574
+ */
+export declare function setPermission(nameOrHash: string, permission: NexusPermissionLevel): Promise<void>;
+/** Convenience: check read access. */
+export declare function canRead(nameOrHash: string): Promise<boolean>;
+/** Convenience: check write access. */
+export declare function canWrite(nameOrHash: string): Promise<boolean>;
+/** Convenience: check execute access. */
+export declare function canExecute(nameOrHash: string): Promise<boolean>;
+//# sourceMappingURL=permissions.d.ts.map

package/dist/core/nexus/permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permissions.d.ts","sourceRoot":"","sources":["../../../src/core/nexus/permissions.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAA+E,KAAK,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAKvI,eAAO,MAAM,qBAAqB;;;;EAAuC,CAAC;AAE1E,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;iBAKtC,CAAC;AACH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC;AAYhF;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAIrF;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,oBAAoB,EAC9B,aAAa,SAAc,GAC1B,OAAO,CAAC,IAAI,CAAC,CAaf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,qBAAqB,CAAC,CAQhC;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,oBAAoB,GAC/B,OAAO,CAAC,IAAI,CAAC,CA0Bf;AAED,sCAAsC;AACtC,wBAAsB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAElE;AAED,uCAAuC;AACvC,wBAAsB,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAEnE;AAED,yCAAyC;AACzC,wBAAsB,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAErE"}