@planu/cli 1.2.0 → 1.3.0

package/dist/engine/e2e-test-generator.js

@@ -0,0 +1,210 @@
+// Planu — E2E Test Generator engine (SPEC-381)
+// Pure functions for generating E2E tests from spec acceptance criteria.
+import { readFile, readdir, mkdir, writeFile } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+function extractAcceptanceCriteria(specContent) {
+    const lines = specContent.split('\n');
+    const criteria = [];
+    for (const line of lines) {
+        const match = /^\s*-\s*\[[ xX]?\]\s+(.+)$/.exec(line);
+        if (match?.[1]) {
+            criteria.push(match[1].trim());
+        }
+    }
+    return criteria;
+}
+/** Extract spec title from frontmatter or first H1. */
+function extractSpecTitle(specContent) {
+    const titleMatch = /^#\s+(.+)$/m.exec(specContent);
+    if (titleMatch?.[1]) {
+        return titleMatch[1].replace(/^SPEC-\d+[:\s-]+/i, '').trim();
+    }
+    const fmMatch = /^title:\s*(.+)$/m.exec(specContent);
+    return fmMatch?.[1]?.trim() ?? 'Spec';
+}
+/** Extract spec description from frontmatter or first paragraph. */
+function extractSpecDescription(specContent) {
+    const descMatch = /^description:\s*(.+)$/m.exec(specContent);
+    if (descMatch?.[1]) {
+        return descMatch[1].trim();
+    }
+    const lines = specContent.split('\n');
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (trimmed &&
+            !trimmed.startsWith('#') &&
+            !trimmed.startsWith('-') &&
+            !trimmed.startsWith('`')) {
+            return trimmed;
+        }
+    }
+    return '';
+}
+/** Generate Gherkin feature file content. */
+export function generateGherkin(title, description, criteria) {
+    const scenarios = criteria
+        .map((criterion) => `  Scenario: ${criterion}\n` +
+        `    Given the system is ready\n` +
+        `    When the user performs the action\n` +
+        `    Then ${criterion}`)
+        .join('\n\n');
+    const descLine = description ? `  ${description}\n\n` : '';
+    return `Feature: ${title}\n${descLine}${scenarios}\n`;
+}
+/** Generate Playwright TypeScript test content. */
+export function generatePlaywright(title, criteria) {
+    const tests = criteria
+        .map((criterion) => `  test('${criterion.replace(/'/g, "\\'")}', async ({ page }) => {\n` +
+        `    // TODO: implement test for: ${criterion}\n` +
+        `  });`)
+        .join('\n\n');
+    return (`import { test, expect } from '@playwright/test';\n\n` +
+        `test.describe('${title.replace(/'/g, "\\'")}', () => {\n` +
+        `${tests}\n` +
+        `});\n`);
+}
+/** Generate testRigor plain English steps. */
+export function generateTestRigor(title, criteria) {
+    const steps = criteria.map((criterion, i) => `${i + 1}. ${criterion}`).join('\n');
+    return `# ${title}\n\n${steps}\n`;
+}
+/** Generate plain numbered list. */
+export function generatePlain(criteria) {
+    return criteria.map((criterion, i) => `${i + 1}. Verify that ${criterion}`).join('\n') + '\n';
+}
+/** Get file extension for each framework. */
+export function getFrameworkExtension(framework) {
+    switch (framework) {
+        case 'gherkin':
+            return 'feature';
+        case 'playwright':
+            return 'spec.ts';
+        case 'testRigor':
+            return 'txt';
+        case 'plain':
+            return 'txt';
+    }
+}
+/** Derive default output path for tests. */
+function deriveDefaultOutputPath(specId, slug, framework) {
+    const ext = getFrameworkExtension(framework);
+    const fileName = `${specId}-${slug}.${ext}`;
+    return join('tests', 'e2e', fileName);
+}
+/** Extract slug from spec directory name. */
+function extractSlug(specDirName) {
+    return specDirName.replace(/^SPEC-\d+-?/i, '').toLowerCase() || 'spec';
+}
+/** Resolve spec directory from specId and projectPath. */
+async function resolveSpecDir(specId, projectPath) {
+    const specsBase = join(projectPath, 'planu', 'specs');
+    let entries;
+    try {
+        entries = await readdir(specsBase);
+    }
+    catch {
+        return null;
+    }
+    const upper = specId.toUpperCase();
+    const match = entries.find((e) => e.toUpperCase().startsWith(upper));
+    return match ? join(specsBase, match) : null;
+}
+/** Generate E2E tests from a spec. */
+export async function generateE2eTests(specId, projectPath, framework = 'gherkin', outputPath) {
+    const specDir = await resolveSpecDir(specId, projectPath);
+    if (!specDir) {
+        return { isError: true, message: `Spec ${specId} not found in ${projectPath}/planu/specs/` };
+    }
+    let specContent;
+    try {
+        specContent = await readFile(join(specDir, 'spec.md'), 'utf8');
+    }
+    catch {
+        return { isError: true, message: `Could not read spec.md for ${specId}` };
+    }
+    const criteria = extractAcceptanceCriteria(specContent);
+    const title = extractSpecTitle(specContent);
+    const description = extractSpecDescription(specContent);
+    let content;
+    switch (framework) {
+        case 'gherkin':
+            content = generateGherkin(title, description, criteria);
+            break;
+        case 'playwright':
+            content = generatePlaywright(title, criteria);
+            break;
+        case 'testRigor':
+            content = generateTestRigor(title, criteria);
+            break;
+        case 'plain':
+            content = generatePlain(criteria);
+            break;
+    }
+    const specDirName = specDir.split('/').pop() ?? specId;
+    const slug = extractSlug(specDirName);
+    const resolvedOutputPath = outputPath ?? deriveDefaultOutputPath(specId, slug, framework);
+    const absoluteOutputPath = resolvedOutputPath.startsWith('/')
+        ? resolvedOutputPath
+        : join(projectPath, resolvedOutputPath);
+    try {
+        const dir = absoluteOutputPath.substring(0, absoluteOutputPath.lastIndexOf('/'));
+        await mkdir(dir, { recursive: true });
+        await writeFile(absoluteOutputPath, content, 'utf8');
+    }
+    catch {
+        // If write fails, still return content without outputPath
+        return {
+            framework,
+            specId,
+            testCount: criteria.length,
+            content,
+            outputPath: null,
+        };
+    }
+    return {
+        framework,
+        specId,
+        testCount: criteria.length,
+        content,
+        outputPath: absoluteOutputPath,
+    };
+}
+/** List existing E2E test files matching SPEC-XXX pattern. */
+export async function getE2eTestStatus(projectPath) {
+    const e2eDir = join(projectPath, 'tests', 'e2e');
+    let files;
+    try {
+        files = await readdir(e2eDir);
+    }
+    catch {
+        return { testFiles: [], total: 0 };
+    }
+    const specPattern = /^(SPEC-\d+)/i;
+    const testFiles = [];
+    for (const file of files) {
+        const ext = extname(file);
+        const isTestFile = file.endsWith('.feature') || file.endsWith('.spec.ts') || file.endsWith('.test.ts');
+        if (!isTestFile) {
+            continue;
+        }
+        const match = specPattern.exec(file);
+        if (!match?.[1]) {
+            continue;
+        }
+        const specId = match[1].toUpperCase();
+        let framework;
+        if (file.endsWith('.feature')) {
+            framework = 'gherkin';
+        }
+        else if (ext === '.ts') {
+            framework = 'playwright';
+        }
+        else {
+            framework = 'unknown';
+        }
+        testFiles.push({ file, specId, framework });
+    }
+    return { testFiles, total: testFiles.length };
+}
+//# sourceMappingURL=e2e-test-generator.js.map

package/dist/engine/e2e-test-generator.js.map

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

package/dist/engine/ecosystem-detector.d.ts

@@ -0,0 +1,13 @@
+import type { TokenOptimizerStatus, TokenOptimizerRecommendation } from '../types/index.js';
+export declare function detectRtkHooks(projectPath: string): Promise<number>;
+export declare function detectHeadroomPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function detectRtkPackage(projectPath: string): Promise<{
+    installed: boolean;
+    version?: string;
+}>;
+export declare function getTokenOptimizerStatus(projectPath: string): Promise<TokenOptimizerStatus>;
+export declare function buildTokenOptimizerRecommendations(projectPath: string): Promise<TokenOptimizerRecommendation[]>;
+//# sourceMappingURL=ecosystem-detector.d.ts.map

package/dist/engine/ecosystem-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ecosystem-detector.d.ts","sourceRoot":"","sources":["../../src/engine/ecosystem-detector.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,oBAAoB,EACpB,4BAA4B,EAG7B,MAAM,mBAAmB,CAAC;AAW3B,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUzE;AAED,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,gBAAgB,CACpC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;IAAE,SAAS,EAAE,OAAO,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBnD;AAED,wBAAsB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAkBhG;AAED,wBAAsB,kCAAkC,CACtD,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,4BAA4B,EAAE,CAAC,CAyDzC"}

package/dist/engine/ecosystem-detector.js

@@ -0,0 +1,128 @@
+// Planu — Ecosystem detector engine (SPEC-374)
+// Pure functions to detect token optimization tools (RTK, Headroom)
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+async function readJsonFile(filePath) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+export async function detectRtkHooks(projectPath) {
+    const settingsPath = join(projectPath, '.claude', 'settings.json');
+    const settings = await readJsonFile(settingsPath);
+    if (!settings?.hooks?.PreToolUse) {
+        return 0;
+    }
+    return settings.hooks.PreToolUse.filter((hook) => {
+        const hooksArr = hook.hooks ?? [];
+        return hooksArr.some((h) => typeof h === 'string' && h.toLowerCase().includes('rtk'));
+    }).length;
+}
+export async function detectHeadroomPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const headroom = allDeps.headroom;
+    const headroomCli = allDeps['@headroom/cli'];
+    const version = headroom ?? headroomCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function detectRtkPackage(projectPath) {
+    const pkgPath = join(projectPath, 'package.json');
+    const pkg = await readJsonFile(pkgPath);
+    if (!pkg) {
+        return { installed: false };
+    }
+    const allDeps = {
+        ...(pkg.devDependencies ?? {}),
+        ...(pkg.dependencies ?? {}),
+    };
+    const rtk = allDeps.rtk;
+    const rtkCli = allDeps['@rtk/cli'];
+    const version = rtk ?? rtkCli;
+    if (version !== undefined) {
+        return { installed: true, version };
+    }
+    return { installed: false };
+}
+export async function getTokenOptimizerStatus(projectPath) {
+    const [rtkPkg, headroomPkg, rtkHooks] = await Promise.all([
+        detectRtkPackage(projectPath),
+        detectHeadroomPackage(projectPath),
+        detectRtkHooks(projectPath),
+    ]);
+    return {
+        rtk: {
+            installed: rtkPkg.installed,
+            version: rtkPkg.version,
+            hooksConfigured: rtkHooks,
+        },
+        headroom: {
+            installed: headroomPkg.installed,
+            version: headroomPkg.version,
+        },
+    };
+}
+export async function buildTokenOptimizerRecommendations(projectPath) {
+    const status = await getTokenOptimizerStatus(projectPath);
+    const recommendations = [];
+    if (!status.rtk.installed) {
+        recommendations.push({
+            tool: 'rtk',
+            installed: false,
+            reason: 'RTK (Response Token Killer) filters verbose Claude output via PreToolUse hooks, reducing token usage by 30-60% on large codebases.',
+            installCommand: 'npm install --save-dev rtk',
+            configExample: JSON.stringify({
+                hooks: {
+                    PreToolUse: [
+                        {
+                            matcher: 'Bash',
+                            hooks: ['npx rtk filter'],
+                        },
+                    ],
+                },
+            }, null, 2),
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'rtk',
+            installed: true,
+            reason: `RTK is installed (${status.rtk.version ?? 'unknown version'}). ${status.rtk.hooksConfigured === 0
+                ? 'No PreToolUse hooks configured yet — add hooks to .claude/settings.json to activate filtering.'
+                : `${String(status.rtk.hooksConfigured)} PreToolUse hook(s) configured.`}`,
+            installCommand: 'npm install --save-dev rtk',
+        });
+    }
+    if (!status.headroom.installed) {
+        recommendations.push({
+            tool: 'headroom',
+            installed: false,
+            reason: 'Headroom monitors your context window usage in real-time and warns before you hit the limit, preventing lost work.',
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    else {
+        recommendations.push({
+            tool: 'headroom',
+            installed: true,
+            reason: `Headroom is installed (${status.headroom.version ?? 'unknown version'}).`,
+            installCommand: 'npm install --save-dev headroom',
+        });
+    }
+    return recommendations;
+}
+//# sourceMappingURL=ecosystem-detector.js.map

package/dist/engine/ecosystem-detector.js.map

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

package/dist/engine/memory-config-generator.d.ts

@@ -0,0 +1,8 @@
+import type { MemoryProvider, MemoryStatusResult, ClaudeJsonConfig } from '../types/index.js';
+export declare function resolveClaudeJsonPath(projectPath: string): string;
+export declare function detectMemoryProvider(config: ClaudeJsonConfig): MemoryProvider;
+export declare function getMemoryStatus(projectPath: string): Promise<MemoryStatusResult>;
+export declare function setupOpenMemory(projectPath: string): Promise<string>;
+export declare function setupMem0Cloud(projectPath: string, apiKey: string): Promise<string>;
+export declare function resetMemoryConfig(projectPath: string): Promise<string>;
+//# sourceMappingURL=memory-config-generator.d.ts.map

package/dist/engine/memory-config-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-config-generator.d.ts","sourceRoot":"","sources":["../../src/engine/memory-config-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAEjB,MAAM,mBAAmB,CAAC;AAe3B,wBAAgB,qBAAqB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,gBAAgB,GAAG,cAAc,CAkB7E;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAWtF;AAED,wBAAsB,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAmB1E;AAED,wBAAsB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAoBzF;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAkB5E"}

package/dist/engine/memory-config-generator.js

@@ -0,0 +1,101 @@
+// Planu — Memory config generator engine (SPEC-375)
+// Generates .claude.json MCP entries for mem0/OpenMemory
+import { readFile, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+async function readClaudeJson(configPath) {
+    try {
+        const content = await readFile(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return {};
+    }
+}
+async function writeClaudeJson(configPath, config) {
+    await writeFile(configPath, JSON.stringify(config, null, 2) + '\n', 'utf-8');
+}
+export function resolveClaudeJsonPath(projectPath) {
+    return join(projectPath, '.claude.json');
+}
+export function detectMemoryProvider(config) {
+    const servers = config.mcpServers;
+    if (servers === undefined) {
+        return 'none';
+    }
+    const memoryServer = servers.memory;
+    if (memoryServer === undefined) {
+        return 'none';
+    }
+    const args = memoryServer.args;
+    if (!args.includes('@mem0/mcp')) {
+        return 'openmemory';
+    }
+    const apiKey = memoryServer.env?.MEM0_API_KEY;
+    if (apiKey !== undefined && apiKey !== '') {
+        return 'mem0-cloud';
+    }
+    return 'openmemory';
+}
+export async function getMemoryStatus(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const provider = detectMemoryProvider(config);
+    return {
+        provider,
+        connected: false,
+        memoryCount: 0,
+        configPath,
+    };
+}
+export async function setupOpenMemory(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const memoryServer = {
+        command: 'npx',
+        args: ['-y', '@mem0/mcp'],
+    };
+    const updated = {
+        ...config,
+        mcpServers: {
+            ...(config.mcpServers ?? {}),
+            memory: memoryServer,
+        },
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+export async function setupMem0Cloud(projectPath, apiKey) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    const memoryServer = {
+        command: 'npx',
+        args: ['-y', '@mem0/mcp'],
+        env: { MEM0_API_KEY: apiKey },
+    };
+    const updated = {
+        ...config,
+        mcpServers: {
+            ...(config.mcpServers ?? {}),
+            memory: memoryServer,
+        },
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+export async function resetMemoryConfig(projectPath) {
+    const configPath = resolveClaudeJsonPath(projectPath);
+    const config = await readClaudeJson(configPath);
+    if (config.mcpServers?.memory === undefined) {
+        return configPath;
+    }
+    const { memory: _removed, ...remainingServers } = config.mcpServers;
+    /* v8 ignore next */
+    void _removed;
+    const updated = {
+        ...config,
+        mcpServers: remainingServers,
+    };
+    await writeClaudeJson(configPath, updated);
+    return configPath;
+}
+//# sourceMappingURL=memory-config-generator.js.map

package/dist/engine/memory-config-generator.js.map

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

package/dist/engine/pr-spec-validator.d.ts

@@ -0,0 +1,25 @@
+import type { CriterionComplianceResult, CriterionStatus, ReviewPrAgainstSpecResult, PrAgentStatusResult } from '../types/index.js';
+/** Extract acceptance criteria from spec.md content (checkbox lines). */
+export declare function extractAcceptanceCriteria(specContent: string): string[];
+/** Resolve spec directory from specId and projectPath. */
+export declare function resolveSpecDir(specId: string, projectPath: string): Promise<string | null>;
+/** Read spec.md content for a given specId. */
+export declare function readSpecContent(specId: string, projectPath: string): Promise<string | null>;
+/** Run `gh pr diff` and return the diff text, or null on failure. */
+export declare function fetchPrDiff(prNumber: number, githubRepo: string): string | null;
+/** Check if a criterion is matched in the diff. */
+export declare function checkCriterion(criterion: string, diff: string): CriterionStatus;
+/** Build compliance results from criteria and diff. */
+export declare function buildComplianceResults(criteria: string[], diff: string): CriterionComplianceResult[];
+/** Calculate compliance score (0-100, rounded integer). */
+export declare function calcComplianceScore(results: CriterionComplianceResult[]): number;
+/** Build the human-readable summary string. */
+export declare function buildSummary(score: number, results: CriterionComplianceResult[], specId: string, prNumber: number): string;
+/** Run the full PR compliance check. */
+export declare function reviewPrAgainstSpec(specId: string, projectPath: string, prNumber: number, githubRepo: string): Promise<ReviewPrAgainstSpecResult | {
+    isError: true;
+    message: string;
+}>;
+/** Check gh CLI installation and PR agent configuration. */
+export declare function checkPrAgentStatus(projectPath: string): PrAgentStatusResult;
+//# sourceMappingURL=pr-spec-validator.d.ts.map

package/dist/engine/pr-spec-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-spec-validator.d.ts","sourceRoot":"","sources":["../../src/engine/pr-spec-validator.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,yBAAyB,EACzB,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,yEAAyE;AACzE,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,CAUvE;AAED,0DAA0D;AAC1D,wBAAsB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYhG;AAED,+CAA+C;AAC/C,wBAAsB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUjG;AAED,qEAAqE;AACrE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAS/E;AAED,mDAAmD;AACnD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,eAAe,CAgB/E;AAED,uDAAuD;AACvD,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,MAAM,EAAE,EAClB,IAAI,EAAE,MAAM,GACX,yBAAyB,EAAE,CAK7B;AAED,2DAA2D;AAC3D,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,yBAAyB,EAAE,GAAG,MAAM,CAMhF;AAED,+CAA+C;AAC/C,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,yBAAyB,EAAE,EACpC,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,MAAM,CAgBR;AAED,wCAAwC;AACxC,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,EACnB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,yBAAyB,GAAG;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAoBzE;AAED,4DAA4D;AAC5D,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,mBAAmB,CAwC3E"}