spectra-cli 4.1.1

package/dist/cli/commands/mcp-server.js

@@ -0,0 +1,90 @@
+/**
+ * mcp-server 子命令
+ * 启动 MCP stdio server，通过 JSON-RPC 2.0 暴露 spectra 工具能力
+ *
+ * dev 模式（--dev flag 或 SPECTRA_DEV=1 环境变量）：
+ *   通过 tsx --watch 启动子进程，文件变更后自动重启，下次 MCP 调用立即使用新代码。
+ *   CI 环境（CI=1 或 SPECTRA_DEV_DISABLE=1）下即使传了 --dev 也强制禁用，避免意外的 watcher 开销。
+ */
+import { spawn } from 'node:child_process';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { startMcpServer } from '../../mcp/index.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * 解析是否应启用 dev 热重载模式
+ *
+ * 规则（按优先级）：
+ *   1. SPECTRA_DEV_DISABLE=1 → 强制禁用，并打印提示
+ *   2. CI=true 或 CI=1      → 强制禁用，并打印提示
+ *   3. --dev flag 或 SPECTRA_DEV=1 → 启用
+ */
+export function resolveDevMode(command) {
+    // CI 强制禁用守卫（优先级最高）
+    if (process.env['SPECTRA_DEV_DISABLE'] === '1') {
+        process.stderr.write('[dev-mode] disabled by SPECTRA_DEV_DISABLE=1\n');
+        return false;
+    }
+    if (process.env['CI'] === 'true' || process.env['CI'] === '1') {
+        process.stderr.write('[dev-mode] disabled by CI env\n');
+        return false;
+    }
+    // 任一条件满足即启用 dev 模式
+    return (command.mcpDev ?? false) || process.env['SPECTRA_DEV'] === '1';
+}
+/**
+ * dev 模式：通过 tsx --watch 启动子进程，父进程负责信号转发
+ *
+ * stdio 策略：inherit — 子进程直接继承父进程的 stdin/stdout/stderr，
+ * MCP JSON-RPC 通信无需额外 pipe 即可透传。
+ *
+ * 子进程 crash 时打印错误但保持父进程存活（不崩溃），
+ * 父进程终止时向子进程发送 SIGTERM 进行干净关闭。
+ */
+function runDevMode() {
+    // MCP server 入口文件的绝对路径（从 dist/cli/commands/ 向上推算 src/mcp/index.ts）
+    // 运行时可能在 dist/ 目录，需要找到对应的 src 路径
+    // 优先尝试本地开发路径（src/），再 fallback 到已编译路径
+    const srcMcpEntry = resolve(__dirname, '..', '..', '..', 'src', 'mcp', 'index.ts');
+    process.stderr.write(`[dev-mode] 启动 tsx --watch: ${srcMcpEntry}\n`);
+    process.stderr.write('[dev-mode] 文件变更后 MCP server 将自动重启\n');
+    const child = spawn('tsx', ['--watch', srcMcpEntry], {
+        stdio: 'inherit',
+        // 确保子进程在父进程退出时也能收到信号
+        detached: false,
+    });
+    child.on('error', (err) => {
+        // tsx 未找到或启动失败时打印错误，不崩溃父进程
+        process.stderr.write(`[dev-mode] 子进程启动失败: ${err.message}\n`);
+        process.stderr.write('[dev-mode] 请确认 tsx 已安装：npm install -D tsx\n');
+    });
+    child.on('exit', (code, signal) => {
+        // 子进程因 crash 退出（非父进程主动终止）时打印提示
+        if (signal !== 'SIGTERM' && signal !== 'SIGINT') {
+            process.stderr.write(`[dev-mode] 子进程退出（code=${String(code ?? 'null')}, signal=${String(signal ?? 'null')}）\n`);
+        }
+    });
+    // 父进程终止时干净关闭子进程
+    const cleanup = (sig) => {
+        if (!child.killed) {
+            child.kill(sig);
+        }
+        process.exit(0);
+    };
+    process.on('SIGTERM', () => cleanup('SIGTERM'));
+    process.on('SIGINT', () => cleanup('SIGINT'));
+}
+/**
+ * 执行 mcp-server 子命令
+ */
+export async function runMcpServer(command) {
+    const isDev = command !== undefined ? resolveDevMode(command) : false;
+    if (isDev) {
+        // dev 模式：spawn tsx --watch 子进程，函数不 await（子进程持续运行）
+        runDevMode();
+        return;
+    }
+    // 非 dev 模式：走现有路径，零性能回归，不初始化任何 watcher
+    await startMcpServer();
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/cli/commands/mcp-server.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * panoramic 子命令 handler
+ * 运行 panoramic 架构分析（cross-package / architecture-ir / overview）
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+export declare function runPanoramicCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=panoramic.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panoramic.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/panoramic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAiBzD,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CA0B5E"}

package/dist/cli/commands/panoramic.js

@@ -0,0 +1,43 @@
+/**
+ * panoramic 子命令 handler
+ * 运行 panoramic 架构分析（cross-package / architecture-ir / overview）
+ */
+import { queryPanoramic } from '../../panoramic/query.js';
+const PANORAMIC_HELP = `spectra panoramic — panoramic 架构分析
+
+用法:
+  spectra panoramic <cross-package|architecture-ir|overview> [--json] [--project-root <dir>]
+
+子操作:
+  cross-package    分析 monorepo 子包间的依赖关系，检测循环依赖，输出拓扑排序
+  architecture-ir  生成统一架构中间表示（Architecture IR），含元素、关系和视图
+  overview         生成架构概览（系统上下文、部署视图、分层视图）
+
+选项:
+  --json           以 JSON 格式输出（默认输出人类可读格式）
+  --project-root   指定分析目标目录（默认为当前工作目录）`;
+export async function runPanoramicCommand(command) {
+    if (command.help || !command.panoramicOperation) {
+        console.log(PANORAMIC_HELP);
+        return;
+    }
+    const operation = command.panoramicOperation;
+    const projectRoot = command.projectRoot ?? process.cwd();
+    const result = await queryPanoramic({ operation, projectRoot });
+    if (!result.ok) {
+        console.error(result.error);
+        process.exitCode = 1;
+        return;
+    }
+    if (command.jsonOutput) {
+        console.log(JSON.stringify(result.data, null, 2));
+    }
+    else {
+        // 人类可读格式：JSON 代码块
+        console.log(`# Panoramic ${operation}\n`);
+        console.log('```json');
+        console.log(JSON.stringify(result.data, null, 2));
+        console.log('```');
+    }
+}
+//# sourceMappingURL=panoramic.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"panoramic.js","sourceRoot":"","sources":["../../../src/cli/commands/panoramic.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAE1D,MAAM,cAAc,GAAG;;;;;;;;;;;;uCAYgB,CAAC;AAExC,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,OAAmB;IAC3D,IAAI,OAAO,CAAC,IAAI,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QAC5B,OAAO;IACT,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEzD,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,EAAE,SAAS,EAAE,WAAW,EAAE,CAAC,CAAC;IAEhE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC5B,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACpD,CAAC;SAAM,CAAC;QACN,kBAAkB;QAClB,OAAO,CAAC,GAAG,CAAC,eAAe,SAAS,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvB,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;AACH,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * prepare 子命令
+ * 执行预处理 + 上下文组装（阶段 1-2），输出结构化 markdown 到 stdout。
+ * 不调用 LLM，不需要 ANTHROPIC_API_KEY。
+ * 供 Claude Code 原生模式消费。
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 prepare 子命令
+ * 进度信息输出到 stderr，结构化数据输出到 stdout
+ */
+export declare function runPrepare(command: CLICommand, version: string): Promise<void>;
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/prepare.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAIzD;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CA4CpF"}

package/dist/cli/commands/prepare.js

@@ -0,0 +1,148 @@
+/**
+ * prepare 子命令
+ * 执行预处理 + 上下文组装（阶段 1-2），输出结构化 markdown 到 stdout。
+ * 不调用 LLM，不需要 ANTHROPIC_API_KEY。
+ * 供 Claude Code 原生模式消费。
+ */
+import { resolve, relative } from 'node:path';
+import { prepareContext } from '../../core/single-spec-orchestrator.js';
+import { ensureSpecifyTemplates } from '../../utils/specify-template-sync.js';
+import { validateTargetPath, handleError, EXIT_CODES, } from '../utils/error-handler.js';
+/**
+ * 执行 prepare 子命令
+ * 进度信息输出到 stderr，结构化数据输出到 stdout
+ */
+export async function runPrepare(command, version) {
+    const target = command.target;
+    const targetPath = resolve(target);
+    // 首次运行自动补齐 .specify/templates（不阻塞主流程）
+    try {
+        ensureSpecifyTemplates(process.cwd());
+    }
+    catch {
+        // 忽略模板同步失败，避免影响 prepare 主流程
+    }
+    // 进度信息 → stderr（不污染 stdout）
+    console.error(`spectra prepare v${version}`);
+    console.error(`正在分析 ${target} ...`);
+    if (!validateTargetPath(targetPath)) {
+        process.exitCode = EXIT_CODES.TARGET_ERROR;
+        return;
+    }
+    // 不检查 API key — prepare 不需要
+    try {
+        const result = await prepareContext(targetPath, {
+            deep: command.deep,
+            projectRoot: process.cwd(),
+        });
+        // 输出结构化 markdown 到 stdout
+        const output = formatPrepareOutput(target, result.skeletons, result.mergedSkeleton, result.context, result.codeSnippets, result.filePaths);
+        console.log(output);
+        console.error(`✓ 预处理完成 (${result.filePaths.length} 文件, ${result.mergedSkeleton.loc} LOC, ${result.context.tokenCount} tokens)`);
+        process.exitCode = EXIT_CODES.SUCCESS;
+    }
+    catch (err) {
+        process.exitCode = handleError(err);
+    }
+}
+/**
+ * 格式化 prepare 输出为结构化 markdown
+ */
+function formatPrepareOutput(target, skeletons, merged, context, codeSnippets, filePaths) {
+    const cwd = process.cwd();
+    const parts = [];
+    // YAML Frontmatter
+    parts.push('---');
+    parts.push('type: prepared-context');
+    parts.push(`target: ${target}`);
+    parts.push(`files: ${filePaths.length}`);
+    parts.push(`loc: ${merged.loc}`);
+    parts.push(`language: ${merged.language}`);
+    parts.push(`parser: ${merged.parserUsed}`);
+    parts.push(`token_count: ${context.tokenCount}`);
+    parts.push(`truncated: ${context.truncated}`);
+    if (context.truncatedParts.length > 0) {
+        parts.push(`truncated_parts: [${context.truncatedParts.join(', ')}]`);
+    }
+    parts.push('---');
+    parts.push('');
+    // 文件清单
+    parts.push('## 文件清单');
+    parts.push('');
+    for (const fp of filePaths) {
+        const relPath = relative(cwd, fp);
+        const skeleton = skeletons.find(s => s.filePath === fp);
+        const loc = skeleton?.loc ?? 0;
+        parts.push(`- \`${relPath}\` (${loc} LOC)`);
+    }
+    parts.push('');
+    // 导出符号
+    parts.push('## 导出符号');
+    parts.push('');
+    if (merged.exports.length > 0) {
+        for (const exp of merged.exports) {
+            parts.push(`### ${exp.kind}: \`${exp.name}\`${exp.isDefault ? ' (default)' : ''}`);
+            if (exp.jsDoc) {
+                parts.push(`> ${exp.jsDoc}`);
+            }
+            parts.push('```typescript');
+            parts.push(exp.signature);
+            parts.push('```');
+            parts.push('');
+        }
+    }
+    else {
+        parts.push('无导出符号。');
+        parts.push('');
+    }
+    // 导入依赖
+    parts.push('## 导入依赖');
+    parts.push('');
+    if (merged.imports.length > 0) {
+        for (const imp of merged.imports) {
+            const typeTag = imp.isTypeOnly ? ' (type-only)' : '';
+            const relTag = imp.isRelative ? '内部' : '外部';
+            parts.push(`- \`${imp.moduleSpecifier}\`${typeTag}（${relTag}）`);
+        }
+    }
+    else {
+        parts.push('无导入依赖。');
+    }
+    parts.push('');
+    // 解析错误
+    if (merged.parseErrors && merged.parseErrors.length > 0) {
+        parts.push('## 解析错误');
+        parts.push('');
+        for (const err of merged.parseErrors) {
+            parts.push(`- ${err.message} (行 ${err.line}:${err.column})`);
+        }
+        parts.push('');
+    }
+    // Token 预算
+    parts.push('## Token 预算');
+    parts.push('');
+    parts.push(`- 骨架: ${context.breakdown.skeleton}`);
+    parts.push(`- 依赖 Spec: ${context.breakdown.dependencies}`);
+    parts.push(`- 代码片段: ${context.breakdown.snippets}`);
+    parts.push(`- 系统指令: ${context.breakdown.instructions}`);
+    parts.push(`- **总计: ${context.tokenCount}**`);
+    if (context.truncated) {
+        parts.push(`- 已裁剪: ${context.truncatedParts.join(', ')}`);
+    }
+    parts.push('');
+    // 代码片段（deep 模式）
+    if (codeSnippets.length > 0) {
+        parts.push('## 代码片段');
+        parts.push('');
+        for (let i = 0; i < codeSnippets.length; i++) {
+            const relPath = i < filePaths.length ? relative(cwd, filePaths[i]) : `片段 ${i + 1}`;
+            parts.push(`### ${relPath}`);
+            parts.push('```typescript');
+            parts.push(codeSnippets[i]);
+            parts.push('```');
+            parts.push('');
+        }
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=prepare.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * query 子命令 handler
+ * 执行知识图谱关键词查询，支持 text 和 json 两种输出格式
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 执行 query 子命令
+ * 加载图谱 → 执行查询 → 按格式输出结果
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export declare function runQueryCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=query.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AA4BzD;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAiDxE"}

package/dist/cli/commands/query.js

@@ -0,0 +1,116 @@
+/**
+ * query 子命令 handler
+ * 执行知识图谱关键词查询，支持 text 和 json 两种输出格式
+ */
+import { existsSync } from 'node:fs';
+import { GraphQueryEngine } from '../../panoramic/graph/graph-query.js';
+import { resolveGraphJsonPath } from '../../panoramic/graph/graph-paths.js';
+const QUERY_HELP = `spectra query — 查询知识图谱
+
+用法:
+  spectra query "<问题>" [--budget <N>] [--format json|text]
+
+说明:
+  基于 _meta/graph.json 知识图谱执行关键词子图查询，
+  返回与查询词相关的模块节点及其依赖关系。
+
+选项:
+  --budget <N>   返回节点数量上限（默认 50）
+  --format       输出格式: text（人类可读，默认）或 json（机器可解析）
+  --help         显示帮助信息
+
+示例:
+  spectra query "认证模块"
+  spectra query "数据库连接" --budget 20 --format json
+  spectra query "CLI 命令" --format text
+
+退出码:
+  0  成功
+  1  查询失败（_meta/graph.json 不存在或解析失败）`;
+/**
+ * 执行 query 子命令
+ * 加载图谱 → 执行查询 → 按格式输出结果
+ *
+ * @param command - 解析后的 CLI 命令对象
+ */
+export async function runQueryCommand(command) {
+    if (command.help) {
+        console.log(QUERY_HELP);
+        return;
+    }
+    const question = command.queryQuestion;
+    const budget = command.budget;
+    const format = command.format ?? 'text';
+    // 校验查询词
+    if (!question || question.trim().length === 0) {
+        console.error('[query] 错误：请提供查询词，例如: spectra query "认证模块"');
+        console.error('运行 spectra query --help 查看帮助');
+        process.exitCode = 1;
+        return;
+    }
+    // 检查 specs/_meta/graph.json 是否存在
+    const graphPath = resolveGraphJsonPath(process.cwd());
+    if (!existsSync(graphPath)) {
+        console.error(`[query] 错误：图谱文件不存在：${graphPath}`);
+        console.error('提示：请先运行 `spectra graph` 命令生成知识图谱。');
+        process.exitCode = 1;
+        return;
+    }
+    // 加载图谱并执行查询
+    let engine;
+    try {
+        engine = GraphQueryEngine.loadFromFile(graphPath);
+    }
+    catch (err) {
+        console.error(`[query] 加载图谱失败：${err instanceof Error ? err.message : String(err)}`);
+        process.exitCode = 1;
+        return;
+    }
+    const result = engine.query(question, { budget });
+    // 按格式输出结果
+    if (format === 'json') {
+        // JSON 格式：保证可通过 JSON.parse 解析（满足 SC-008）
+        console.log(JSON.stringify(result, null, 2));
+    }
+    else {
+        // text 格式：生成人类可读摘要
+        outputTextFormat(question, result);
+    }
+}
+/**
+ * 以人类可读文本格式输出查询结果
+ * @param question - 原始查询词
+ * @param result - 查询结果
+ */
+function outputTextFormat(question, result) {
+    console.log(`\n查询: "${question}"`);
+    console.log(`${result.summary}\n`);
+    if (result.nodes.length === 0) {
+        console.log('（未找到匹配节点）');
+        return;
+    }
+    // 输出节点列表
+    console.log('匹配节点:');
+    for (const node of result.nodes) {
+        const sourcePath = node.metadata['sourcePath'] ?? '';
+        const pathInfo = sourcePath ? ` (${sourcePath})` : '';
+        console.log(`  [${node.kind}] ${node.label}${pathInfo}`);
+    }
+    // 输出关系摘要（若有边）
+    if (result.edges.length > 0) {
+        console.log(`\n关系 (共 ${result.edges.length} 条):`);
+        // 最多展示前 10 条边，避免输出过长
+        const displayEdges = result.edges.slice(0, 10);
+        for (const edge of displayEdges) {
+            console.log(`  ${edge.source} --[${edge.relation}]--> ${edge.target} (${edge.confidence})`);
+        }
+        if (result.edges.length > 10) {
+            console.log(`  ... 还有 ${result.edges.length - 10} 条关系（使用 --format json 查看全部）`);
+        }
+    }
+    if (result.truncated) {
+        console.log(`\n注意：结果已截断，原始匹配节点数：${result.totalMatches}`);
+        console.log('使用 --budget <N> 调整返回节点数量上限。');
+    }
+}
+//# sourceMappingURL=query.js.map

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

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

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

@@ -0,0 +1,16 @@
+/**
+ * watch 子命令 handler
+ * 监听文件变更，自动触发增量文档同步
+ */
+import type { CLICommand } from '../utils/parse-args.js';
+/**
+ * 检测是否有外部 batch 进程正在运行（FR-010）
+ * 宁可漏检也不崩溃——异常时返回 false
+ */
+export declare function isExternalBatchRunning(): boolean;
+/**
+ * 执行 watch 子命令
+ * 启动文件监听，变更触发后自动调用 runBatch({ incremental: true })
+ */
+export declare function runWatchCommand(command: CLICommand): Promise<void>;
+//# sourceMappingURL=watch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"watch.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/watch.ts"],"names":[],"mappings":"AAAA;;;GAGG;AASH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAiBzD;;;GAGG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAYhD;AAwCD;;;GAGG;AACH,wBAAsB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAqFxE"}