@sunilp-org/jam-cli 0.1.0 → 0.1.1

package/dist/utils/context.js

@@ -0,0 +1,383 @@
+/**
+ * JAM.md — persistent project context file.
+ *
+ * Automatically discovers project details (language, structure, dependencies,
+ * patterns) and writes a `JAM.md` at the workspace root.  This file is read
+ * by `jam ask` / `jam chat` and injected into the system prompt so the model
+ * starts every conversation with a deep understanding of the project.
+ *
+ * Users can (and should) edit JAM.md to add domain-specific notes, coding
+ * conventions, architectural decisions, etc.
+ */
+import { readFile, writeFile, readdir, access, constants } from 'node:fs/promises';
+import { basename, join } from 'node:path';
+export const CONTEXT_FILENAME = 'JAM.md';
+// ── Read existing JAM.md ──────────────────────────────────────────────────────
+/**
+ * Load `JAM.md` from the workspace root.  Returns `null` if not found.
+ */
+export async function loadContextFile(workspaceRoot) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    try {
+        return await readFile(contextPath, 'utf-8');
+    }
+    catch {
+        return null;
+    }
+}
+/** Recursively build a directory tree string (max depth). */
+async function buildTree(dir, prefix, depth, maxDepth) {
+    if (depth > maxDepth)
+        return '';
+    let entries;
+    try {
+        entries = await readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return '';
+    }
+    // Filter out noise
+    const filtered = entries
+        .filter((e) => {
+        const name = String(e.name);
+        if (name.startsWith('.'))
+            return false;
+        if (['node_modules', 'dist', 'build', 'coverage', '__pycache__', '.next', '.nuxt', 'target', 'out'].includes(name))
+            return false;
+        return true;
+    })
+        .sort((a, b) => {
+        // Dirs first, then files
+        if (a.isDirectory() && !b.isDirectory())
+            return -1;
+        if (!a.isDirectory() && b.isDirectory())
+            return 1;
+        return String(a.name).localeCompare(String(b.name));
+    });
+    const lines = [];
+    for (let i = 0; i < filtered.length; i++) {
+        const entry = filtered[i];
+        const name = String(entry.name);
+        const isLast = i === filtered.length - 1;
+        const connector = isLast ? '└── ' : '├── ';
+        const childPrefix = isLast ? '    ' : '│   ';
+        if (entry.isDirectory()) {
+            lines.push(`${prefix}${connector}${name}/`);
+            const subtree = await buildTree(join(dir, name), prefix + childPrefix, depth + 1, maxDepth);
+            if (subtree)
+                lines.push(subtree);
+        }
+        else {
+            lines.push(`${prefix}${connector}${name}`);
+        }
+    }
+    return lines.join('\n');
+}
+/** Detect language, framework, and other details from filesystem. */
+async function discoverProject(workspaceRoot) {
+    const info = {
+        name: basename(workspaceRoot),
+        language: 'unknown',
+        framework: 'none detected',
+        packageManager: 'unknown',
+        description: '',
+        entryPoint: '',
+        testFramework: '',
+        scripts: {},
+        dependencies: [],
+        devDependencies: [],
+        structure: '',
+    };
+    // ── package.json (Node / TS / JS) ──────────────────────────────────────────
+    try {
+        const pkgRaw = await readFile(join(workspaceRoot, 'package.json'), 'utf-8');
+        const pkg = JSON.parse(pkgRaw);
+        info.name = pkg['name'] ?? info.name;
+        info.description = pkg['description'] ?? '';
+        info.entryPoint = pkg['main'] ?? (pkg['bin'] ? JSON.stringify(pkg['bin']) : '');
+        const scripts = pkg['scripts'];
+        if (scripts)
+            info.scripts = scripts;
+        const deps = pkg['dependencies'];
+        if (deps)
+            info.dependencies = Object.keys(deps);
+        const devDeps = pkg['devDependencies'];
+        if (devDeps)
+            info.devDependencies = Object.keys(devDeps);
+        // Detect package manager
+        const lockFiles = [
+            ['bun.lockb', 'bun'],
+            ['pnpm-lock.yaml', 'pnpm'],
+            ['yarn.lock', 'yarn'],
+            ['package-lock.json', 'npm'],
+        ];
+        for (const [file, mgr] of lockFiles) {
+            try {
+                await access(join(workspaceRoot, file), constants.F_OK);
+                info.packageManager = mgr;
+                break;
+            }
+            catch { /* skip */ }
+        }
+        // Detect frameworks from deps
+        const allDeps = [...info.dependencies, ...info.devDependencies];
+        if (allDeps.includes('commander') || allDeps.includes('yargs') || allDeps.includes('oclif'))
+            info.framework = 'CLI application';
+        else if (allDeps.includes('next'))
+            info.framework = 'Next.js';
+        else if (allDeps.includes('nuxt'))
+            info.framework = 'Nuxt';
+        else if (allDeps.includes('svelte'))
+            info.framework = 'Svelte';
+        else if (allDeps.includes('vue'))
+            info.framework = 'Vue';
+        else if (allDeps.includes('react'))
+            info.framework = 'React';
+        else if (allDeps.includes('express'))
+            info.framework = 'Express';
+        else if (allDeps.includes('fastify'))
+            info.framework = 'Fastify';
+        // Detect test framework
+        if (allDeps.includes('vitest'))
+            info.testFramework = 'Vitest';
+        else if (allDeps.includes('jest'))
+            info.testFramework = 'Jest';
+        else if (allDeps.includes('mocha'))
+            info.testFramework = 'Mocha';
+    }
+    catch { /* not a node project */ }
+    // ── Language detection ──────────────────────────────────────────────────────
+    try {
+        await access(join(workspaceRoot, 'tsconfig.json'), constants.F_OK);
+        info.language = 'TypeScript';
+    }
+    catch {
+        try {
+            await access(join(workspaceRoot, 'package.json'), constants.F_OK);
+            info.language = 'JavaScript';
+        }
+        catch { /* fallthrough */ }
+    }
+    // Python detection
+    if (info.language === 'unknown') {
+        for (const marker of ['pyproject.toml', 'setup.py', 'requirements.txt', 'Pipfile']) {
+            try {
+                await access(join(workspaceRoot, marker), constants.F_OK);
+                info.language = 'Python';
+                break;
+            }
+            catch { /* skip */ }
+        }
+    }
+    // Go
+    if (info.language === 'unknown') {
+        try {
+            await access(join(workspaceRoot, 'go.mod'), constants.F_OK);
+            info.language = 'Go';
+        }
+        catch { /* skip */ }
+    }
+    // Rust
+    if (info.language === 'unknown') {
+        try {
+            await access(join(workspaceRoot, 'Cargo.toml'), constants.F_OK);
+            info.language = 'Rust';
+        }
+        catch { /* skip */ }
+    }
+    // ── Build directory tree ───────────────────────────────────────────────────
+    info.structure = await buildTree(workspaceRoot, '', 0, 3);
+    return info;
+}
+/** File extension hint for the language. */
+function langFileHint(lang) {
+    switch (lang) {
+        case 'TypeScript': return '`.ts` / `.tsx`';
+        case 'JavaScript': return '`.js` / `.jsx`';
+        case 'Python': return '`.py`';
+        case 'Go': return '`.go`';
+        case 'Rust': return '`.rs`';
+        default: return '';
+    }
+}
+/**
+ * Generate JAM.md content by auto-discovering the project.
+ */
+export async function generateContextContent(workspaceRoot) {
+    const info = await discoverProject(workspaceRoot);
+    const sections = [];
+    // Header
+    sections.push(`# ${info.name}`);
+    sections.push('');
+    sections.push('> This file was auto-generated by `jam context init`.');
+    sections.push('> Edit it freely — Jam reads it on every `ask` / `chat` invocation.');
+    sections.push('');
+    // Overview
+    sections.push('## Overview');
+    sections.push('');
+    if (info.description)
+        sections.push(info.description);
+    sections.push('');
+    sections.push(`| Property | Value |`);
+    sections.push(`|----------|-------|`);
+    sections.push(`| Language | ${info.language} |`);
+    if (langFileHint(info.language)) {
+        sections.push(`| File extensions | ${langFileHint(info.language)} |`);
+    }
+    if (info.framework !== 'none detected') {
+        sections.push(`| Framework | ${info.framework} |`);
+    }
+    if (info.packageManager !== 'unknown') {
+        sections.push(`| Package manager | ${info.packageManager} |`);
+    }
+    if (info.entryPoint) {
+        sections.push(`| Entry point | \`${info.entryPoint}\` |`);
+    }
+    if (info.testFramework) {
+        sections.push(`| Test framework | ${info.testFramework} |`);
+    }
+    sections.push('');
+    // Scripts
+    if (Object.keys(info.scripts).length > 0) {
+        sections.push('## Scripts');
+        sections.push('');
+        sections.push('```bash');
+        for (const [name, cmd] of Object.entries(info.scripts)) {
+            sections.push(`${info.packageManager !== 'unknown' ? info.packageManager : 'npm'} run ${name}  # ${cmd}`);
+        }
+        sections.push('```');
+        sections.push('');
+    }
+    // Directory structure
+    if (info.structure) {
+        sections.push('## Directory Structure');
+        sections.push('');
+        sections.push('```');
+        sections.push(info.structure);
+        sections.push('```');
+        sections.push('');
+    }
+    // Key dependencies
+    if (info.dependencies.length > 0) {
+        sections.push('## Key Dependencies');
+        sections.push('');
+        for (const dep of info.dependencies) {
+            sections.push(`- \`${dep}\``);
+        }
+        sections.push('');
+    }
+    // Dev dependencies (abbreviated)
+    if (info.devDependencies.length > 0) {
+        sections.push('## Dev Dependencies');
+        sections.push('');
+        for (const dep of info.devDependencies) {
+            sections.push(`- \`${dep}\``);
+        }
+        sections.push('');
+    }
+    // User editable sections
+    sections.push('## Architecture Notes');
+    sections.push('');
+    sections.push('<!-- Add notes about the project architecture, key patterns, design decisions, etc. -->');
+    sections.push('');
+    sections.push('## Coding Conventions');
+    sections.push('');
+    sections.push('<!-- Add notes about coding style, naming conventions, import patterns, etc. -->');
+    sections.push('');
+    sections.push('## Important Context');
+    sections.push('');
+    sections.push('<!-- Add anything else Jam should know when answering questions about this project. -->');
+    sections.push('');
+    return sections.join('\n');
+}
+/**
+ * Write JAM.md to the workspace root. Returns the path written.
+ */
+export async function writeContextFile(workspaceRoot, content) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    await writeFile(contextPath, content, 'utf-8');
+    return contextPath;
+}
+/**
+ * Check if JAM.md already exists.
+ */
+export async function contextFileExists(workspaceRoot) {
+    try {
+        await access(join(workspaceRoot, CONTEXT_FILENAME), constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ── Auto-update JAM.md with usage patterns (P2-7) ────────────────────────────
+const USAGE_SECTION_HEADER = '## Frequently Accessed Files';
+const USAGE_SECTION_MARKER = '<!-- jam-auto-usage -->';
+/**
+ * Update JAM.md with frequently accessed file patterns from the session.
+ * Appends or replaces a "Frequently Accessed Files" section.
+ *
+ * @param workspaceRoot  Workspace root path
+ * @param readFiles      Array of file paths accessed during sessions
+ * @param searchQueries  Array of search queries used during sessions
+ */
+export async function updateContextWithUsage(workspaceRoot, readFiles, searchQueries) {
+    const contextPath = join(workspaceRoot, CONTEXT_FILENAME);
+    let existing;
+    try {
+        existing = await readFile(contextPath, 'utf-8');
+    }
+    catch {
+        return; // No JAM.md — nothing to update
+    }
+    // Count file access frequency
+    const fileCounts = new Map();
+    for (const f of readFiles) {
+        fileCounts.set(f, (fileCounts.get(f) ?? 0) + 1);
+    }
+    // Sort by frequency
+    const topFiles = [...fileCounts.entries()]
+        .sort((a, b) => b[1] - a[1])
+        .slice(0, 15)
+        .map(([path, count]) => `- \`${path}\` (${count}x)`);
+    if (topFiles.length === 0)
+        return;
+    const usageSection = [
+        '',
+        USAGE_SECTION_HEADER,
+        '',
+        USAGE_SECTION_MARKER,
+        '',
+        '> Auto-updated by Jam based on your usage patterns. These are the files most frequently',
+        '> examined when answering questions. Jam will prioritize searching these locations.',
+        '',
+        ...topFiles,
+        '',
+        ...(searchQueries.length > 0 ? [
+            '### Common Search Patterns',
+            '',
+            ...searchQueries.slice(0, 10).map(q => `- \`${q}\``),
+            '',
+        ] : []),
+        USAGE_SECTION_MARKER,
+        '',
+    ].join('\n');
+    // Replace existing usage section or append
+    const markerStart = existing.indexOf(USAGE_SECTION_MARKER);
+    if (markerStart !== -1) {
+        const markerEnd = existing.indexOf(USAGE_SECTION_MARKER, markerStart + USAGE_SECTION_MARKER.length);
+        if (markerEnd !== -1) {
+            // Find the section header before first marker
+            const headerPos = existing.lastIndexOf(USAGE_SECTION_HEADER, markerStart);
+            const sectionStart = headerPos !== -1 ? headerPos : markerStart;
+            const sectionEnd = markerEnd + USAGE_SECTION_MARKER.length;
+            const updated = existing.slice(0, sectionStart) + usageSection + existing.slice(sectionEnd);
+            await writeFile(contextPath, updated, 'utf-8');
+            return;
+        }
+    }
+    // Append to end
+    const updated = existing.trimEnd() + '\n' + usageSection;
+    await writeFile(contextPath, updated, 'utf-8');
+}
+//# sourceMappingURL=context.js.map

package/dist/utils/context.js.map

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

package/dist/utils/critic.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Critic agent — evaluates the main agent's answer for quality and relevance.
+ *
+ * Replaces the naive keyword-matching `checkAnswerRelevance` with a real
+ * LLM-based evaluation.  The critic runs as a separate, cheap LLM call
+ * with a focused system prompt.
+ */
+import type { ProviderAdapter } from '../providers/base.js';
+export interface CriticVerdict {
+    /** Whether the answer passes quality checks. */
+    pass: boolean;
+    /** Brief reason if it fails. */
+    reason: string;
+    /** Confidence 0-1 (from the critic's self-assessment). */
+    confidence: number;
+}
+/**
+ * Run the critic agent to evaluate an answer.
+ *
+ * Uses a low temperature and short max tokens for fast, focused evaluation.
+ * Falls back to PASS if the critic call fails (non-blocking).
+ */
+export declare function criticEvaluate(provider: ProviderAdapter, question: string, answer: string, options?: {
+    model?: string;
+}): Promise<CriticVerdict>;
+/**
+ * Build a correction message from the critic's feedback.
+ * More specific than the generic buildCorrectionMessage.
+ */
+export declare function buildCriticCorrection(verdict: CriticVerdict, originalQuestion: string): string;
+//# sourceMappingURL=critic.d.ts.map

package/dist/utils/critic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic.d.ts","sourceRoot":"","sources":["../../src/utils/critic.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAI5D,MAAM,WAAW,aAAa;IAC5B,gDAAgD;IAChD,IAAI,EAAE,OAAO,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,0DAA0D;IAC1D,UAAU,EAAE,MAAM,CAAC;CACpB;AAiCD;;;;;GAKG;AACH,wBAAsB,cAAc,CAClC,QAAQ,EAAE,eAAe,EACzB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/B,OAAO,CAAC,aAAa,CAAC,CAqCxB;AAiCD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,GAAG,MAAM,CAgB9F"}

package/dist/utils/critic.js

@@ -0,0 +1,126 @@
+/**
+ * Critic agent — evaluates the main agent's answer for quality and relevance.
+ *
+ * Replaces the naive keyword-matching `checkAnswerRelevance` with a real
+ * LLM-based evaluation.  The critic runs as a separate, cheap LLM call
+ * with a focused system prompt.
+ */
+// ── Critic prompt ─────────────────────────────────────────────────────────────
+const CRITIC_SYSTEM_PROMPT = `You are a strict answer quality evaluator for a code assistant.
+
+You will receive:
+1. The user's ORIGINAL QUESTION
+2. The assistant's PROPOSED ANSWER
+
+Evaluate the answer on these criteria:
+- RELEVANCE: Does the answer address the user's specific question?
+- SPECIFICITY: Does the answer reference specific files, line numbers, or code?
+- ACCURACY: Does the answer appear technically correct (no obvious hallucinations)?
+- COMPLETENESS: Does the answer cover the main aspects of the question?
+- FORMAT: Is the answer in clean Markdown (not raw JSON, not gibberish)?
+
+Respond in EXACTLY this format (no extra text):
+PASS or FAIL
+CONFIDENCE: 0.0-1.0
+REASON: one sentence explanation
+
+Examples:
+PASS
+CONFIDENCE: 0.9
+REASON: Answer correctly identifies the provider factory pattern in src/providers/factory.ts with specific line references.
+
+FAIL
+CONFIDENCE: 0.8
+REASON: Answer describes the context.ts file but the user asked about LLM providers — completely off-topic.`;
+// ── Critic execution ──────────────────────────────────────────────────────────
+/**
+ * Run the critic agent to evaluate an answer.
+ *
+ * Uses a low temperature and short max tokens for fast, focused evaluation.
+ * Falls back to PASS if the critic call fails (non-blocking).
+ */
+export async function criticEvaluate(provider, question, answer, options = {}) {
+    // Skip critic for very short answers (handled by basic validation)
+    if (answer.trim().length < 30) {
+        return { pass: false, reason: 'Answer is too short to be useful.', confidence: 1.0 };
+    }
+    try {
+        const request = {
+            messages: [{
+                    role: 'user',
+                    content: [
+                        '## Original Question',
+                        '',
+                        question,
+                        '',
+                        '## Proposed Answer',
+                        '',
+                        answer.slice(0, 3000), // Cap answer length sent to critic
+                    ].join('\n'),
+                }],
+            model: options.model,
+            temperature: 0.1,
+            maxTokens: 150,
+            systemPrompt: CRITIC_SYSTEM_PROMPT,
+        };
+        let response = '';
+        const stream = provider.streamCompletion(request);
+        for await (const chunk of stream) {
+            if (!chunk.done)
+                response += chunk.delta;
+        }
+        return parseCriticResponse(response.trim());
+    }
+    catch {
+        // Critic failure is non-fatal — default to pass
+        return { pass: true, reason: 'Critic evaluation failed, defaulting to pass.', confidence: 0.0 };
+    }
+}
+/**
+ * Parse the critic's structured response.
+ */
+function parseCriticResponse(text) {
+    const lines = text.split('\n').map(l => l.trim()).filter(Boolean);
+    if (lines.length === 0) {
+        return { pass: true, reason: 'Empty critic response.', confidence: 0.0 };
+    }
+    const firstLine = lines[0].toUpperCase();
+    const pass = firstLine.includes('PASS');
+    // Extract confidence
+    let confidence = 0.5;
+    const confLine = lines.find(l => l.toUpperCase().startsWith('CONFIDENCE'));
+    if (confLine) {
+        const match = confLine.match(/[\d.]+/);
+        if (match)
+            confidence = Math.min(1, Math.max(0, parseFloat(match[0])));
+    }
+    // Extract reason
+    let reason = 'No reason provided.';
+    const reasonLine = lines.find(l => l.toUpperCase().startsWith('REASON'));
+    if (reasonLine) {
+        reason = reasonLine.replace(/^REASON:\s*/i, '').trim();
+    }
+    return { pass, reason, confidence };
+}
+/**
+ * Build a correction message from the critic's feedback.
+ * More specific than the generic buildCorrectionMessage.
+ */
+export function buildCriticCorrection(verdict, originalQuestion) {
+    return [
+        `[CRITIC FEEDBACK: Your answer was rejected.]`,
+        '',
+        `Reason: ${verdict.reason}`,
+        '',
+        `The user's original question was: "${originalQuestion}"`,
+        '',
+        'Provide a NEW answer that:',
+        '1. Directly addresses the question above',
+        '2. References specific file paths, line numbers, and code snippets',
+        '3. Is formatted in clean Markdown',
+        '4. Does NOT repeat your previous answer',
+        '',
+        'If you need more information, use tools to search and read code first.',
+    ].join('\n');
+}
+//# sourceMappingURL=critic.js.map

package/dist/utils/critic.js.map

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

package/dist/utils/index-builder.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Symbol index builder — lightweight file→symbol mapping for faster retrieval.
+ *
+ * Scans source files for exported symbols (functions, classes, interfaces,
+ * types, constants) and builds an index file at `.jam/symbol-index.json`.
+ *
+ * The index is used by the planner and enrichment stages to suggest specific
+ * files to the model based on symbol names, reducing wasted search rounds.
+ */
+export interface SymbolEntry {
+    /** Symbol name (function, class, interface, variable name). */
+    name: string;
+    /** Kind of symbol. */
+    kind: 'function' | 'class' | 'interface' | 'type' | 'const' | 'enum' | 'variable';
+    /** File path relative to workspace root. */
+    file: string;
+    /** 1-based line number where the symbol is defined. */
+    line: number;
+}
+export interface SymbolIndex {
+    /** When the index was built (ISO timestamp). */
+    builtAt: string;
+    /** Number of files scanned. */
+    filesScanned: number;
+    /** Total symbols found. */
+    totalSymbols: number;
+    /** All symbol entries. */
+    symbols: SymbolEntry[];
+}
+/**
+ * Build a symbol index for the workspace.
+ * Scans all source files and extracts exported symbols.
+ */
+export declare function buildSymbolIndex(workspaceRoot: string): Promise<SymbolIndex>;
+/**
+ * Load the cached symbol index from disk.
+ * Returns null if no index exists or it's too stale.
+ */
+export declare function loadSymbolIndex(workspaceRoot: string, maxAge?: number): Promise<SymbolIndex | null>;
+/**
+ * Load or build the symbol index (builds if missing/stale).
+ */
+export declare function getOrBuildIndex(workspaceRoot: string): Promise<SymbolIndex>;
+/**
+ * Search the symbol index for symbols matching a query.
+ * Returns matching symbols sorted by relevance.
+ */
+export declare function searchSymbols(index: SymbolIndex, query: string, maxResults?: number): SymbolEntry[];
+/**
+ * Format symbol search results for injection into context.
+ */
+export declare function formatSymbolResults(symbols: SymbolEntry[]): string;
+//# sourceMappingURL=index-builder.d.ts.map

package/dist/utils/index-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index-builder.d.ts","sourceRoot":"","sources":["../../src/utils/index-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,WAAW,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IAClF,4CAA4C;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,WAAW;IAC1B,gDAAgD;IAChD,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,OAAO,EAAE,WAAW,EAAE,CAAC;CACxB;AAoJD;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CA6ClF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACnC,aAAa,EAAE,MAAM,EACrB,MAAM,GAAE,MAAuB,GAC9B,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAa7B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAIjF;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,MAAM,EACb,UAAU,GAAE,MAAW,GACtB,WAAW,EAAE,CAyBf;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAUlE"}