@sudosandwich/limps 0.2.0 → 0.3.0

package/dist/cli/list-plans.js

@@ -0,0 +1,218 @@
+/**
+ * CLI command: list-plans
+ * Lists all plans in the configured plansPath.
+ */
+import { existsSync, readdirSync, readFileSync } from 'fs';
+import { join } from 'path';
+import { stripMarkdown } from '../utils/markdown.js';
+/**
+ * Extract plan number from directory name.
+ * Handles both padded (0001-plan-name) and unpadded (1-plan-name) formats.
+ */
+export function extractPlanNumber(dirName) {
+    const match = dirName.match(/^(\d+)-/);
+    if (match) {
+        return match[1];
+    }
+    return null;
+}
+/**
+ * Extract plan name from directory name.
+ * Removes the number prefix and converts dashes to spaces.
+ */
+export function extractPlanName(dirName) {
+    const match = dirName.match(/^\d+-(.+)$/);
+    if (match) {
+        return match[1].replace(/-/g, ' ').replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+    return dirName;
+}
+/**
+ * Detect work type from plan content or directory name.
+ */
+export function detectWorkType(dirName, content) {
+    const lowerDir = dirName.toLowerCase();
+    const lowerContent = content.toLowerCase();
+    if (lowerDir.includes('bug') || lowerContent.includes('bug fix')) {
+        return 'bug';
+    }
+    if (lowerDir.includes('refactor') || lowerContent.includes('refactor')) {
+        return 'refactor';
+    }
+    if (lowerDir.includes('doc') || lowerContent.includes('documentation')) {
+        return 'docs';
+    }
+    if (lowerDir.includes('feature') ||
+        lowerDir.includes('feat') ||
+        lowerContent.includes('feature')) {
+        return 'feature';
+    }
+    return 'unknown';
+}
+/**
+ * Parse YAML frontmatter from content.
+ */
+function parseYamlFrontmatter(content) {
+    const yamlRegex = /^---\s*\n([\s\S]*?)\n---\s*\n/;
+    const match = content.match(yamlRegex);
+    if (!match) {
+        return {};
+    }
+    const frontmatterText = match[1];
+    const frontmatter = {};
+    const lines = frontmatterText.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIndex = trimmed.indexOf(':');
+        if (colonIndex === -1)
+            continue;
+        const key = trimmed.slice(0, colonIndex).trim();
+        let value = trimmed.slice(colonIndex + 1).trim();
+        if (typeof value === 'string') {
+            if ((value.startsWith('"') && value.endsWith('"')) ||
+                (value.startsWith("'") && value.endsWith("'"))) {
+                value = value.slice(1, -1);
+            }
+        }
+        if (key) {
+            frontmatter[key] = value;
+        }
+    }
+    return frontmatter;
+}
+/**
+ * Extract overview from plan content.
+ * Looks for content after the title and before the first section.
+ */
+export function extractOverview(content) {
+    // Remove frontmatter
+    const withoutFrontmatter = content.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, '');
+    // Find content between title and first ## heading
+    const lines = withoutFrontmatter.split('\n');
+    const overviewLines = [];
+    let foundTitle = false;
+    for (const line of lines) {
+        if (line.startsWith('# ') && !foundTitle) {
+            foundTitle = true;
+            continue;
+        }
+        if (foundTitle) {
+            if (line.startsWith('## ') || line.startsWith('### ')) {
+                break;
+            }
+            const trimmed = line.trim();
+            if (trimmed) {
+                // Skip lines that look like raw metadata (e.g., `**Status:** Draft **Date:** 2026-01-15`)
+                // These are common when frontmatter leaks into content
+                if (/^\*\*[A-Za-z]+\*\*:\s*.*(\*\*[A-Za-z]+\*\*:.*)?$/.test(trimmed)) {
+                    continue;
+                }
+                // Skip horizontal rules
+                if (/^[-*_]{3,}$/.test(trimmed)) {
+                    continue;
+                }
+                overviewLines.push(trimmed);
+            }
+        }
+    }
+    const overview = overviewLines.join(' ');
+    // Strip markdown for clean CLI display
+    const cleaned = stripMarkdown(overview);
+    const truncated = cleaned.slice(0, 100);
+    return truncated.length === 100 ? truncated + '...' : truncated;
+}
+/**
+ * Get plan status from frontmatter or default.
+ */
+export function getPlanStatus(content) {
+    const frontmatter = parseYamlFrontmatter(content);
+    if (frontmatter.status && typeof frontmatter.status === 'string') {
+        const status = frontmatter.status.toUpperCase();
+        if (['GAP', 'WIP', 'PASS', 'BLOCKED'].includes(status)) {
+            return status;
+        }
+    }
+    return 'GAP';
+}
+/**
+ * Get all plans data from the configured plansPath.
+ * Returns structured data for rendering.
+ *
+ * @param config - Server configuration
+ * @returns Structured plan data or error message
+ */
+export function getPlansData(config) {
+    const plansPath = config.plansPath;
+    if (!existsSync(plansPath)) {
+        return { error: 'No plans found (plans directory does not exist)' };
+    }
+    const dirs = readdirSync(plansPath, { withFileTypes: true })
+        .filter((dirent) => dirent.isDirectory())
+        .map((dirent) => dirent.name);
+    const plans = [];
+    for (const dir of dirs) {
+        const planNumber = extractPlanNumber(dir);
+        if (!planNumber) {
+            continue;
+        }
+        const planMdPath = join(plansPath, dir, 'plan.md');
+        let content = '';
+        if (existsSync(planMdPath)) {
+            try {
+                content = readFileSync(planMdPath, 'utf-8');
+            }
+            catch {
+                // Ignore read errors
+            }
+        }
+        plans.push({
+            number: planNumber,
+            name: extractPlanName(dir),
+            workType: detectWorkType(dir, content),
+            overview: extractOverview(content),
+            status: getPlanStatus(content),
+        });
+    }
+    if (plans.length === 0) {
+        return { error: 'No plans found' };
+    }
+    // Sort by plan number
+    plans.sort((a, b) => parseInt(a.number, 10) - parseInt(b.number, 10));
+    return { plans, total: plans.length };
+}
+/**
+ * List all plans from the configured plansPath.
+ *
+ * @param config - Server configuration
+ * @returns Formatted string output for CLI
+ */
+export function listPlans(config) {
+    const result = getPlansData(config);
+    if ('error' in result) {
+        return result.error;
+    }
+    const { plans } = result;
+    // Format output
+    const lines = [];
+    lines.push('Plans:');
+    lines.push('');
+    for (const plan of plans) {
+        const statusIcon = {
+            GAP: ' ',
+            WIP: '*',
+            PASS: '+',
+            BLOCKED: '!',
+        }[plan.status];
+        lines.push(`[${statusIcon}] ${plan.number.padStart(4, '0')} - ${plan.name}`);
+        lines.push(`    Type: ${plan.workType} | Status: ${plan.status}`);
+        if (plan.overview) {
+            lines.push(`    ${plan.overview}`);
+        }
+        lines.push('');
+    }
+    lines.push(`Total: ${plans.length} plan(s)`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=list-plans.js.map

package/dist/cli/list-plans.js.map

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

package/dist/cli/next-task.d.ts

@@ -0,0 +1,83 @@
+/**
+ * CLI command: next-task
+ * Get the next best task with scoring breakdown.
+ */
+import type { ServerConfig } from '../config.js';
+import { type CoordinationState } from '../coordination.js';
+import { type ParsedAgentFile } from '../agent-parser.js';
+/**
+ * Score breakdown for a task.
+ */
+export interface TaskScoreBreakdown {
+    taskId: string;
+    agentNumber: string;
+    title: string;
+    totalScore: number;
+    dependencyScore: number;
+    priorityScore: number;
+    workloadScore: number;
+    reasons: string[];
+}
+/**
+ * Calculate dependency score (40% weight).
+ * Higher score when all dependencies are satisfied.
+ */
+declare function calculateDependencyScore(agent: ParsedAgentFile, coordination: CoordinationState): {
+    score: number;
+    reasons: string[];
+};
+/**
+ * Calculate priority score (30% weight).
+ * Lower agent numbers get higher priority.
+ */
+declare function calculatePriorityScore(agent: ParsedAgentFile): {
+    score: number;
+    reasons: string[];
+};
+/**
+ * Calculate workload score (30% weight).
+ * Based on file count - fewer files = easier task = higher score.
+ */
+declare function calculateWorkloadScore(agent: ParsedAgentFile): {
+    score: number;
+    reasons: string[];
+};
+/**
+ * Check if task is eligible (GAP status, no file conflicts).
+ */
+declare function isTaskEligible(agent: ParsedAgentFile, coordination: CoordinationState): {
+    eligible: boolean;
+    reason?: string;
+};
+/**
+ * Score a task and return breakdown.
+ */
+declare function scoreTask(agent: ParsedAgentFile, coordination: CoordinationState): TaskScoreBreakdown | null;
+/**
+ * Result of getting next task.
+ */
+export interface NextTaskResult {
+    task: TaskScoreBreakdown;
+    otherAvailableTasks: number;
+}
+/**
+ * Get the next best task data from a plan.
+ * Returns structured data for rendering.
+ *
+ * @param config - Server configuration
+ * @param planId - Plan number or name
+ * @returns Structured task data or error message
+ */
+export declare function getNextTaskData(config: ServerConfig, planId: string): Promise<NextTaskResult | {
+    error: string;
+}>;
+/**
+ * Get the next best task from a plan.
+ *
+ * @param config - Server configuration
+ * @param planId - Plan number or name
+ * @returns Formatted string output for CLI
+ */
+export declare function nextTask(config: ServerConfig, planId: string): Promise<string>;
+export { calculateDependencyScore, calculatePriorityScore, calculateWorkloadScore, isTaskEligible, scoreTask, };
+//# sourceMappingURL=next-task.d.ts.map

package/dist/cli/next-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next-task.d.ts","sourceRoot":"","sources":["../../src/cli/next-task.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAoB,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC9E,OAAO,EAAE,KAAK,eAAe,EAAqB,MAAM,oBAAoB,CAAC;AAG7E;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;GAGG;AACH,iBAAS,wBAAwB,CAC/B,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,iBAAiB,GAC9B;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CA4BtC;AAED;;;GAGG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAU5F;AAED;;;GAGG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,eAAe,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAS5F;AAED;;GAEG;AACH,iBAAS,cAAc,CACrB,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,iBAAiB,GAC9B;IAAE,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAkCxC;AAED;;GAEG;AACH,iBAAS,SAAS,CAChB,KAAK,EAAE,eAAe,EACtB,YAAY,EAAE,iBAAiB,GAC9B,kBAAkB,GAAG,IAAI,CAsB3B;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,kBAAkB,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,cAAc,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CA4C7C;AAED;;;;;;GAMG;AACH,wBAAsB,QAAQ,CAAC,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAgCpF;AAGD,OAAO,EACL,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EACd,SAAS,GACV,CAAC"}

package/dist/cli/next-task.js

@@ -0,0 +1,201 @@
+/**
+ * CLI command: next-task
+ * Get the next best task with scoring breakdown.
+ */
+import { readCoordination } from '../coordination.js';
+import { resolveDependency } from '../agent-parser.js';
+import { findPlanDirectory, getAgentFiles } from './list-agents.js';
+/**
+ * Calculate dependency score (40% weight).
+ * Higher score when all dependencies are satisfied.
+ */
+function calculateDependencyScore(agent, coordination) {
+    const reasons = [];
+    const deps = agent.frontmatter.dependencies;
+    if (deps.length === 0) {
+        reasons.push('No dependencies (unblocked)');
+        return { score: 40, reasons };
+    }
+    let satisfiedCount = 0;
+    for (const dep of deps) {
+        const taskId = resolveDependency(dep, agent.planFolder);
+        if (taskId) {
+            const depTask = coordination.tasks[taskId];
+            if (depTask && depTask.status === 'PASS') {
+                satisfiedCount++;
+            }
+        }
+    }
+    if (satisfiedCount === deps.length) {
+        reasons.push(`All ${deps.length} dependencies satisfied`);
+        return { score: 40, reasons };
+    }
+    const unsatisfied = deps.length - satisfiedCount;
+    reasons.push(`${unsatisfied}/${deps.length} dependencies not satisfied`);
+    return { score: 0, reasons };
+}
+/**
+ * Calculate priority score (30% weight).
+ * Lower agent numbers get higher priority.
+ */
+function calculatePriorityScore(agent) {
+    const reasons = [];
+    const agentNum = parseInt(agent.agentNumber, 10);
+    // Agents 0-2 get full priority score
+    // Score decreases for higher agent numbers
+    const score = Math.max(0, 30 - agentNum * 3);
+    reasons.push(`Agent #${agentNum} priority: ${score}/30`);
+    return { score, reasons };
+}
+/**
+ * Calculate workload score (30% weight).
+ * Based on file count - fewer files = easier task = higher score.
+ */
+function calculateWorkloadScore(agent) {
+    const reasons = [];
+    const fileCount = agent.frontmatter.files.length;
+    // Fewer files = higher score (max 30)
+    const score = Math.max(0, 30 - fileCount * 5);
+    reasons.push(`${fileCount} files to modify: ${score}/30`);
+    return { score, reasons };
+}
+/**
+ * Check if task is eligible (GAP status, no file conflicts).
+ */
+function isTaskEligible(agent, coordination) {
+    if (agent.frontmatter.status !== 'GAP') {
+        return {
+            eligible: false,
+            reason: `Status is ${agent.frontmatter.status}, not GAP`,
+        };
+    }
+    // Check file conflicts
+    for (const file of agent.frontmatter.files) {
+        const lockedBy = coordination.fileLocks[file];
+        if (lockedBy) {
+            return {
+                eligible: false,
+                reason: `File ${file} is locked by ${lockedBy}`,
+            };
+        }
+    }
+    // Check dependency satisfaction
+    for (const dep of agent.frontmatter.dependencies) {
+        const taskId = resolveDependency(dep, agent.planFolder);
+        if (taskId) {
+            const depTask = coordination.tasks[taskId];
+            if (!depTask || depTask.status !== 'PASS') {
+                return {
+                    eligible: false,
+                    reason: `Dependency ${dep} not satisfied`,
+                };
+            }
+        }
+    }
+    return { eligible: true };
+}
+/**
+ * Score a task and return breakdown.
+ */
+function scoreTask(agent, coordination) {
+    const eligibility = isTaskEligible(agent, coordination);
+    if (!eligibility.eligible) {
+        return null;
+    }
+    const depResult = calculateDependencyScore(agent, coordination);
+    const priorityResult = calculatePriorityScore(agent);
+    const workloadResult = calculateWorkloadScore(agent);
+    const totalScore = depResult.score + priorityResult.score + workloadResult.score;
+    return {
+        taskId: agent.taskId,
+        agentNumber: agent.agentNumber,
+        title: agent.title || `Agent ${agent.agentNumber}`,
+        totalScore,
+        dependencyScore: depResult.score,
+        priorityScore: priorityResult.score,
+        workloadScore: workloadResult.score,
+        reasons: [...depResult.reasons, ...priorityResult.reasons, ...workloadResult.reasons],
+    };
+}
+/**
+ * Get the next best task data from a plan.
+ * Returns structured data for rendering.
+ *
+ * @param config - Server configuration
+ * @param planId - Plan number or name
+ * @returns Structured task data or error message
+ */
+export async function getNextTaskData(config, planId) {
+    const planDir = findPlanDirectory(config.plansPath, planId);
+    if (!planDir) {
+        return { error: `Plan not found: ${planId}` };
+    }
+    const agents = getAgentFiles(planDir);
+    if (agents.length === 0) {
+        return { error: 'No agents found' };
+    }
+    // Load coordination state
+    const coordination = await readCoordination(config.coordinationPath);
+    // Score all eligible tasks
+    const scoredTasks = [];
+    for (const agent of agents) {
+        const score = scoreTask(agent, coordination);
+        if (score) {
+            scoredTasks.push(score);
+        }
+    }
+    if (scoredTasks.length === 0) {
+        // Check if all tasks are complete
+        const passCount = agents.filter((a) => a.frontmatter.status === 'PASS').length;
+        if (passCount === agents.length) {
+            return { error: 'All tasks completed!' };
+        }
+        return { error: 'No available tasks (all blocked or in progress)' };
+    }
+    // Sort by total score (descending)
+    scoredTasks.sort((a, b) => b.totalScore - a.totalScore);
+    const best = scoredTasks[0];
+    return {
+        task: best,
+        otherAvailableTasks: scoredTasks.length - 1,
+    };
+}
+/**
+ * Get the next best task from a plan.
+ *
+ * @param config - Server configuration
+ * @param planId - Plan number or name
+ * @returns Formatted string output for CLI
+ */
+export async function nextTask(config, planId) {
+    const result = await getNextTaskData(config, planId);
+    if ('error' in result) {
+        return result.error;
+    }
+    const { task: best, otherAvailableTasks } = result;
+    // Format output
+    const lines = [];
+    lines.push('Next Best Task:');
+    lines.push('');
+    lines.push(`  Task ID: ${best.taskId}`);
+    lines.push(`  Title: ${best.title}`);
+    lines.push('');
+    lines.push('Score Breakdown:');
+    lines.push(`  Total Score: ${best.totalScore}/100`);
+    lines.push(`  Dependencies: ${best.dependencyScore}/40`);
+    lines.push(`  Priority: ${best.priorityScore}/30`);
+    lines.push(`  Workload: ${best.workloadScore}/30`);
+    lines.push('');
+    lines.push('Scoring Reasons:');
+    for (const reason of best.reasons) {
+        lines.push(`  - ${reason}`);
+    }
+    if (otherAvailableTasks > 0) {
+        lines.push('');
+        lines.push(`Other available tasks: ${otherAvailableTasks}`);
+    }
+    return lines.join('\n');
+}
+// Export scoring functions for testing
+export { calculateDependencyScore, calculatePriorityScore, calculateWorkloadScore, isTaskEligible, scoreTask, };
+//# sourceMappingURL=next-task.js.map

package/dist/cli/next-task.js.map

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

package/dist/cli/registry.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Project registry for managing limps configurations.
+ * Stores a mapping of project names to config paths, enabling
+ * users to switch between projects without specifying --config each time.
+ */
+/**
+ * A registered project entry in the registry.
+ */
+export interface RegisteredProject {
+    /** Absolute path to the project's config.json file */
+    configPath: string;
+    /** ISO timestamp when the project was registered */
+    registeredAt: string;
+}
+/**
+ * The project registry file structure.
+ */
+export interface ProjectRegistry {
+    /** Schema version for future migrations */
+    version: 1;
+    /** Currently active project name, or null if none set */
+    current: string | null;
+    /** Map of project names to their registration info */
+    projects: Record<string, RegisteredProject>;
+}
+/**
+ * Get the path to the registry file.
+ * Uses XDG-compliant location: ~/.config/limps/registry.json
+ *
+ * @returns Absolute path to registry.json
+ */
+export declare function getRegistryPath(): string;
+/**
+ * Load the project registry from disk.
+ * Returns an empty registry if the file doesn't exist.
+ *
+ * @returns The project registry
+ */
+export declare function loadRegistry(): ProjectRegistry;
+/**
+ * Save the project registry to disk.
+ * Uses atomic write (write to temp, then rename) to prevent corruption.
+ *
+ * @param registry - The registry to save
+ */
+export declare function saveRegistry(registry: ProjectRegistry): void;
+/**
+ * Register a new project in the registry.
+ *
+ * @param name - Project name (used as identifier)
+ * @param configPath - Absolute path to the project's config.json
+ */
+export declare function registerProject(name: string, configPath: string): void;
+/**
+ * Unregister a project from the registry.
+ * If the project is the current project, clears the current selection.
+ * Does not delete any files, only removes the registry entry.
+ *
+ * @param name - Project name to unregister
+ * @throws Error if the project is not registered
+ */
+export declare function unregisterProject(name: string): void;
+/**
+ * Set the current/default project.
+ *
+ * @param name - Project name to set as current, or null to clear
+ * @throws Error if the project is not registered
+ */
+export declare function setCurrentProject(name: string | null): void;
+/**
+ * Get the config path for the current project.
+ *
+ * @returns Config path if a current project is set and exists, null otherwise
+ */
+export declare function getCurrentProjectPath(): string | null;
+/**
+ * Get the config path for a specific project by name.
+ *
+ * @param name - Project name to look up
+ * @returns Config path if found, null otherwise
+ */
+export declare function getProjectPath(name: string): string | null;
+/**
+ * List all registered projects.
+ *
+ * @returns Array of project info objects
+ */
+export declare function listProjects(): {
+    name: string;
+    current: boolean;
+    configPath: string;
+    registeredAt: string;
+}[];
+//# sourceMappingURL=registry.d.ts.map

package/dist/cli/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/cli/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,UAAU,EAAE,MAAM,CAAC;IACnB,oDAAoD;IACpD,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,OAAO,EAAE,CAAC,CAAC;IACX,yDAAyD;IACzD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;CAC7C;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,eAAe,CAqB9C;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAQ5D;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI,CAOtE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAepD;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAW3D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,GAAG,IAAI,CAarD;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAI1D;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB,EAAE,CAWF"}