spec-manager 0.1.0

package/dist/cli/task.js

@@ -0,0 +1,287 @@
+/**
+ * task 子命令：
+ *   create <spec> --plan <file> [--auto-confirm]
+ *   start <task-id>
+ *   step <task-id> --no <N> --status <s> [--type T] [--name S] [--tool T] [--output-json J] [--input-json J] [--latency L] [--error-code E] [--error-message M]
+ *   complete <task-id>
+ *   fail <task-id> [--code E] [--msg M]
+ *   wait <task-id> [--reason R]
+ *   show <task-id> [--full]
+ *   list [--topic T] [--spec S] [--status running]
+ */
+import { readFileSync } from 'node:fs';
+import { getPaths } from '../core/paths.js';
+import { createTask, startTask, reportStep, completeTask, failTask, waitTask, showTask, listTasks, } from '../core/task.js';
+import { listDecisions } from '../core/decision.js';
+import { findSpecByCode } from '../core/spec-io.js';
+import { hit as auditHit } from '../core/audit.js';
+import { StepStatusSchema } from '../schemas/spec.js';
+const TASK_STATUSES = ['draft', 'running', 'waiting', 'completed', 'failed'];
+export function registerTaskCommands(program) {
+    const task = program
+        .command('task')
+        .description('Agent Task 生命周期管理（创建/执行步骤/完成/失败）');
+    task
+        .command('create <specCode>')
+        .description('为 frozen L3 spec 创建 Agent Task（R3）')
+        .requiredOption('--plan <file>', 'planJson 文件路径（含 steps[]）')
+        .option('--auto-confirm', 'human_gate 自动通过', false)
+        .option('--json', '以 JSON 格式输出', false)
+        .action((specCode, opts) => {
+        const paths = getPaths();
+        const planJson = JSON.parse(readFileSync(opts.plan, 'utf8'));
+        const result = createTask({
+            paths,
+            specCode,
+            planJson,
+            autoConfirm: opts.autoConfirm,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`✓ Task ${result.task.id} created for ${specCode}`);
+        console.log(`  file: ${result.taskFile}`);
+        console.log(`  status: ${result.task.status}`);
+        console.log(`  steps: ${planJson.steps.length}`);
+    });
+    task
+        .command('start <taskId>')
+        .description('把 Task 状态从 draft/running 推进到 running')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .action((taskId, opts) => {
+        const paths = getPaths();
+        const updated = startTask(paths, taskId, opts.spec);
+        console.log(`✓ Task ${updated.id} → running`);
+        console.log(`  startedAt: ${updated.startedAt}`);
+    });
+    task
+        .command('step <taskId>')
+        .description('上报一个 step 的执行结果（写入 task JSON steps[]）')
+        .requiredOption('--no <stepNo>', '步骤编号', (v) => v)
+        .requiredOption('--status <status>', '状态: pending|running|succeeded|failed|skipped')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .option('--type <type>', '步骤类型（llm_call|mcp_tool|human_gate）')
+        .option('--name <name>', '步骤名称')
+        .option('--tool <toolName>', '工具名（如 Read/Write）')
+        .option('--input-json <json>', '输入 JSON 字符串')
+        .option('--output-json <json>', '输出 JSON 字符串（必含 summary，R15）')
+        .option('--latency <ms>', '耗时（毫秒）', (v) => Number(v))
+        .option('--error-code <code>', '错误代码')
+        .option('--error-message <msg>', '错误信息')
+        .action((taskId, opts) => {
+        // Zod 校验 status
+        const parsed = StepStatusSchema.safeParse(opts.status);
+        if (!parsed.success) {
+            console.error(`✗ --status 非法: ${opts.status}（必须 pending|running|succeeded|failed|skipped）`);
+            process.exit(2);
+        }
+        const paths = getPaths();
+        const result = reportStep({
+            paths,
+            taskId,
+            specCode: opts.spec,
+            stepNo: opts.no,
+            status: parsed.data,
+            toolName: opts.tool,
+            inputJson: opts.inputJson,
+            outputJson: opts.outputJson,
+            latencyMs: opts.latency,
+            errorCode: opts.errorCode,
+            errorMessage: opts.errorMessage,
+        });
+        console.log(`✓ Step ${opts.no} reported for task ${taskId}`);
+        for (const w of result.warnings)
+            console.warn(`⚠ ${w}`);
+    });
+    task
+        .command('complete <taskId>')
+        .description('标记 Task 完成 → 触发 L3 spec cascade → implemented')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .option('--json', '以 JSON 格式输出 cascade 结果', false)
+        .action((taskId, opts) => {
+        const paths = getPaths();
+        const result = completeTask({ paths, taskId, specCode: opts.spec });
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`✓ Task ${result.task.id} → completed`);
+        console.log(`  finishedAt: ${result.task.finishedAt}`);
+        if (result.cascadedSpecs.length > 0) {
+            console.log('  cascaded:');
+            for (const c of result.cascadedSpecs) {
+                console.log(`    ${c.code} (${c.level}): ${c.oldStatus} → ${c.newStatus}`);
+            }
+        }
+        if (result.skippedSpecs.length > 0) {
+            console.log('  skipped:');
+            for (const s of result.skippedSpecs) {
+                console.log(`    ${s.code} (${s.reason})`);
+            }
+        }
+        // R18 自检:对每个新 implemented 的 L1,检查是否已有决策卡片,自动 audit hit 落库
+        if (result.cascadedL1Specs.length > 0) {
+            console.log('');
+            console.log('⚠ R18 (决策卡片):以下 L1 已 cascade 到 implemented');
+            for (const code of result.cascadedL1Specs) {
+                const existing = listDecisions(paths, { docCode: code, includeAll: true });
+                const spec = findSpecByCode(paths, code);
+                const topic = spec?.fm.topic ?? '?';
+                // 自动 audit hit:无论是否已建,都记录"已检查"这一事实
+                auditHit({ paths, ruleId: 'R18', specCode: code });
+                if (existing.length === 0) {
+                    console.log(`  ✗ ${code} [${topic}] — 待建 (audit hit R18 已落库)`);
+                    console.log(`    spec-manager decision create ${code} \\`);
+                    console.log(`      --topic ${topic} --what "..." --why "..." --criteria AC-1,AC-2`);
+                }
+                else {
+                    const active = existing.filter(d => d.fm.status === 'active');
+                    console.log(`  ✓ ${code} [${topic}] — 已有 ${existing.length} 张 (active: ${active.length}, audit hit R18 已落库)`);
+                }
+            }
+        }
+    });
+    task
+        .command('fail <taskId>')
+        .description('标记 Task 失败')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .option('--code <code>', '错误代码', 'AGENT_TOOL')
+        .option('--msg <message>', '错误信息', '未知错误')
+        .action((taskId, opts) => {
+        const paths = getPaths();
+        const updated = failTask({
+            paths,
+            taskId,
+            specCode: opts.spec,
+            errorCode: opts.code,
+            errorMessage: opts.msg,
+        });
+        console.log(`✗ Task ${updated.id} → failed`);
+        console.log(`  ${opts.code}: ${opts.msg}`);
+    });
+    task
+        .command('wait <taskId>')
+        .description('把 Task 标记为 waiting（等人工确认）')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .option('--reason <reason>', '等待原因', '需要人工确认')
+        .action((taskId, opts) => {
+        const paths = getPaths();
+        const updated = waitTask({ paths, taskId, specCode: opts.spec, reason: opts.reason });
+        console.log(`⏸ Task ${updated.id} → waiting`);
+        console.log(`  reason: ${updated.waitReason}`);
+    });
+    task
+        .command('show <taskId>')
+        .description('查看 Task 详情（默认 last 5 steps + totalSteps）')
+        .option('--spec <specCode>', '限定查找范围（避免跨 spec 的 T-001 冲突）')
+        .option('--full', '返回完整 steps 列表', false)
+        .option('--json', '以 JSON 格式输出', false)
+        .action((taskId, opts) => {
+        const paths = getPaths();
+        const result = showTask(paths, taskId, { full: opts.full, specCode: opts.spec });
+        if (!result) {
+            console.error(`✗ Task not found: ${taskId}`);
+            process.exit(1);
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+            return;
+        }
+        console.log(`Task ${result.task.id} — ${result.task.specCode}`);
+        console.log(`  status: ${result.task.status}`);
+        console.log(`  startedAt: ${result.task.startedAt ?? '-'}`);
+        console.log(`  finishedAt: ${result.task.finishedAt ?? '-'}`);
+        if (result.task.waitReason)
+            console.log(`  waitReason: ${result.task.waitReason}`);
+        if (result.task.errorCode)
+            console.log(`  error: ${result.task.errorCode} — ${result.task.errorMessage}`);
+        console.log(`  steps: ${result.steps.length} (totalSteps: ${result.steps.length}${result.truncated ? ', truncated' : ''})`);
+        if (result.steps.length > 0) {
+            for (const s of result.steps) {
+                const lat = s.latencyMs != null ? ` (${s.latencyMs}ms)` : '';
+                console.log(`    [${s.stepNo}] ${s.status.padEnd(10)} ${s.name}${lat}`);
+            }
+        }
+    });
+    task
+        .command('list')
+        .description('列出所有 Task（可按 topic / spec / status 过滤）')
+        .option('--topic <topic>', '按 topic 过滤（连续性层：执行前查同主题历史任务）')
+        .option('--spec <specCode>', '按 spec code 过滤')
+        .option('--status <status>', '按 status 过滤（draft|running|waiting|completed|failed）')
+        .option('--json', '以 JSON 格式输出', false)
+        .action((opts) => {
+        const paths = getPaths();
+        if (opts.status && !TASK_STATUSES.includes(opts.status)) {
+            console.error(`✗ --status 非法: ${opts.status}（必须 ${TASK_STATUSES.join('|')}）`);
+            process.exit(2);
+        }
+        const all = listTasks(paths, {
+            topic: opts.topic,
+            specCode: opts.spec,
+            status: opts.status,
+        });
+        if (opts.json) {
+            console.log(JSON.stringify(all, null, 2));
+            return;
+        }
+        if (all.length === 0) {
+            console.log('(no tasks)');
+            return;
+        }
+        for (const t of all) {
+            console.log(`${t.id}  ${t.status.padEnd(10)}  ${t.specCode}  created=${t.created}`);
+        }
+    });
+    // ── batch: 一条命令完成 create → start → step×N → complete ──
+    task
+        .command('batch <specCode>')
+        .description('一条命令完成 Agent Task 全生命周期（create + start + step×N + complete）')
+        .requiredOption('--plan <file>', 'planJson 文件路径（含 steps[]）')
+        .option('--auto-confirm', 'human_gate 自动通过', false)
+        .option('--json', '以 JSON 格式输出', false)
+        .action((specCode, opts) => {
+        const paths = getPaths();
+        const planJson = JSON.parse(readFileSync(opts.plan, 'utf8'));
+        // 1. create
+        const { task: created } = createTask({ paths, specCode, planJson, autoConfirm: opts.autoConfirm });
+        console.log(`✓ Task ${created.id} created for ${specCode}`);
+        console.log(`  steps: ${planJson.steps.length}`);
+        // 2. start
+        startTask(paths, created.id, specCode);
+        console.log(`✓ Task ${created.id} → running`);
+        // 3. step × N
+        for (const step of planJson.steps) {
+            const outputJson = JSON.stringify({ summary: `step ${step.stepNo}: ${step.name}` });
+            reportStep({
+                paths,
+                taskId: created.id,
+                specCode,
+                stepNo: step.stepNo,
+                status: 'succeeded',
+                outputJson,
+            });
+            console.log(`  [${step.stepNo}/${planJson.steps.length}] ${step.name}... succeeded`);
+        }
+        // 4. complete
+        const result = completeTask({ paths, taskId: created.id, specCode });
+        console.log(`✓ Task ${result.task.id} → completed`);
+        if (result.cascadedSpecs.length > 0) {
+            console.log('  cascaded:');
+            for (const c of result.cascadedSpecs) {
+                console.log(`    ${c.code} (${c.level}): ${c.oldStatus} → ${c.newStatus}`);
+            }
+        }
+        if (result.skippedSpecs.length > 0) {
+            console.log('  skipped:');
+            for (const s of result.skippedSpecs) {
+                console.log(`    ${s.code} (${s.reason})`);
+            }
+        }
+        if (opts.json) {
+            console.log(JSON.stringify(result, null, 2));
+        }
+    });
+}
+//# sourceMappingURL=task.js.map

package/dist/cli/task.js.map

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

package/dist/cli/usability.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerUsabilityCommands(program: Command): void;
+//# sourceMappingURL=usability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"usability.d.ts","sourceRoot":"","sources":["../../src/cli/usability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAYpC,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAmIhE"}

package/dist/cli/usability.js

@@ -0,0 +1,153 @@
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { readFileSync, writeFileSync } from 'node:fs';
+import { getPaths } from '../core/paths.js';
+import { createSpec, findSpecByCode, generateSpecCode, updateSpec } from '../core/spec-io.js';
+import { canTransition } from '../core/status.js';
+import { createTask, startTask } from '../core/task.js';
+import { getFlowStatus, renderTemplate, runProjectDoctor, suggestAfterSpecCommand } from '../core/usability.js';
+import { fail, requireInitialized } from './common.js';
+export function registerUsabilityCommands(program) {
+    program
+        .command('flow')
+        .description('流程视图：按 topic 展示 L1/L2/L3/Task 当前状态与下一步')
+        .command('status')
+        .option('--topic <topic>', '只查看指定 topic')
+        .action((opts) => {
+        const paths = getPaths();
+        requireInitialized(paths);
+        const flows = getFlowStatus(paths, { topic: opts.topic });
+        if (flows.length === 0) {
+            console.log('(no topics)');
+            console.log('Next: spec-manager spec new L1 --topic <topic> --title "..."');
+            return;
+        }
+        for (const flow of flows) {
+            console.log(flow.topic);
+            if (flow.specs.length === 0) {
+                console.log('  (no specs)');
+            }
+            else {
+                for (const spec of flow.specs) {
+                    console.log(`  ${spec.fm.code.padEnd(28)} ${spec.fm.level.padEnd(3)} ${spec.fm.status.padEnd(12)} ${spec.fm.title}`);
+                }
+            }
+            const activeTasks = flow.tasks.filter((t) => t.status !== 'completed' && t.status !== 'failed');
+            if (activeTasks.length > 0) {
+                console.log('  tasks:');
+                for (const task of activeTasks)
+                    console.log(`    ${task.id} ${task.status} ${task.specCode}`);
+            }
+            console.log(`  Next: ${flow.nextAction}`);
+        }
+    });
+    program
+        .command('guide [request...]')
+        .description('新手向导：检查项目状态并给出下一步')
+        .action((requestParts) => {
+        const request = requestParts.join(' ').trim();
+        const paths = getPaths();
+        if (!paths.isInitialized) {
+            console.log('Next: spec-manager project init --name <project-name>');
+            return;
+        }
+        const doctor = runProjectDoctor(paths);
+        const blocking = doctor.find((c) => c.status === 'fail' || c.status === 'warn');
+        if (blocking?.action) {
+            console.log(`Next: ${blocking.action}`);
+            return;
+        }
+        const topic = inferTopic(request) ?? '<topic>';
+        const flow = getFlowStatus(paths, { topic })[0];
+        console.log(`Request: ${request || '(none)'}`);
+        console.log(`Next: ${flow?.nextAction ?? `spec-manager spec new L1 --topic ${topic} --title "..."`}`);
+    });
+    program
+        .command('new')
+        .description('常用创建快捷入口')
+        .command('feature')
+        .argument('<title...>', '功能标题')
+        .requiredOption('--topic <topic>', 'topic 名')
+        .option('--allow-duplicate-topic', '允许同 topic 下创建额外 L1', false)
+        .action((titleParts, opts) => {
+        const paths = getPaths();
+        requireInitialized(paths);
+        const title = titleParts.join(' ');
+        const code = generateSpecCode(opts.topic, 'L1');
+        if (findSpecByCode(paths, code)) {
+            fail(`✗ code 已存在: ${code}\nNext: spec-manager flow status --topic ${opts.topic}`, 2);
+        }
+        const rec = createSpec({
+            paths,
+            code,
+            level: 'L1',
+            title,
+            topic: opts.topic,
+            parentCode: null,
+        });
+        console.log(`✓ Created feature L1: ${rec.fm.code}`);
+        console.log(`  file: ${rec.filePath}`);
+        console.log(`Next: ${suggestAfterSpecCommand(rec)}`);
+    });
+    program
+        .command('approve <code>')
+        .description('快捷批准当前 spec：draft→confirmed，L3 confirmed→frozen')
+        .action((code) => {
+        const paths = getPaths();
+        requireInitialized(paths);
+        const rec = findSpecByCode(paths, code);
+        if (!rec)
+            fail(`✗ 未找到: ${code}`, 1);
+        const target = rec.fm.level === 'L3' && rec.fm.status === 'confirmed' ? 'frozen' : 'confirmed';
+        if (!canTransition(rec.fm.status, target)) {
+            fail(`✗ 状态非法: ${rec.fm.status} → ${target}\nNext: spec-manager flow status --topic ${rec.fm.topic}`, 2);
+        }
+        const { record } = updateSpec(paths, code, { status: target, changeSummary: `${rec.fm.status} → ${target}` });
+        console.log(`✓ ${code}: ${rec.fm.status} → ${target}`);
+        console.log(`Next: ${suggestAfterSpecCommand(record)}`);
+    });
+    program
+        .command('run <specCode>')
+        .description('快捷执行 frozen L3：create task + start')
+        .requiredOption('--plan <file>', 'planJson 文件路径')
+        .option('--auto-confirm', 'human_gate 自动通过', false)
+        .action((specCode, opts) => {
+        const paths = getPaths();
+        requireInitialized(paths);
+        const planJson = JSON.parse(readFileSync(opts.plan, 'utf8'));
+        const { task } = createTask({ paths, specCode, planJson, autoConfirm: opts.autoConfirm });
+        const started = startTask(paths, task.id, specCode);
+        console.log(`✓ Task ${started.id} created and started for ${specCode}`);
+        console.log(`Next: spec-manager task step ${started.id} --spec ${specCode} --no <N> --status succeeded --output-json '{"summary":"..."}'`);
+    });
+    program
+        .command('template <level>')
+        .description('输出 L0/L1/L2/L3 或 agent-plan 模板')
+        .option('--title <title>', '替换模板标题', 'Untitled')
+        .option('--output <file>', '写入文件；不传则输出到 stdout')
+        .action((levelRaw, opts) => {
+        const level = normalizeTemplateLevel(levelRaw);
+        const packageRoot = join(dirname(fileURLToPath(import.meta.url)), '..', '..');
+        const content = renderTemplate(packageRoot, level, opts.title);
+        if (opts.output) {
+            writeFileSync(opts.output, content, 'utf8');
+            console.log(`✓ Template written: ${opts.output}`);
+        }
+        else {
+            process.stdout.write(content);
+        }
+    });
+}
+function normalizeTemplateLevel(input) {
+    const normalized = input.toUpperCase();
+    if (['L0', 'L1', 'L2', 'L3'].includes(normalized))
+        return normalized;
+    if (input === 'agent-plan' || input === 'plan')
+        return 'agent-plan';
+    fail('✗ template level 必须是 L0/L1/L2/L3/agent-plan', 2);
+}
+function inferTopic(input) {
+    const first = input.toLowerCase().match(/[a-z0-9][a-z0-9-]*/)?.[0];
+    return first ?? null;
+}
+//# sourceMappingURL=usability.js.map

package/dist/cli/usability.js.map

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

package/dist/core/agents.d.ts

@@ -0,0 +1,43 @@
+import type { ProjectPaths } from './paths.js';
+export declare const AGENT_PROVIDERS: readonly ["claude", "codex", "opencode", "codebuddy"];
+export type AgentProvider = (typeof AGENT_PROVIDERS)[number];
+export type AgentProviderSelection = AgentProvider | 'all';
+export interface AgentProviderInfo {
+    provider: AgentProvider;
+    aliases: string[];
+    files: string[];
+    description: string;
+    notes: string[];
+    installSteps: AgentInstallStep[];
+}
+export type AgentInstallStep = {
+    kind: 'template';
+    source: string;
+    target: string;
+} | {
+    kind: 'directory';
+    source: string;
+    target: string;
+};
+export interface InstallAgentSupportOptions {
+    paths: ProjectPaths;
+    packageRoot: string;
+    providers: AgentProviderSelection[];
+    force?: boolean;
+    dryRun?: boolean;
+}
+export interface AgentInstallReport {
+    providers: AgentProvider[];
+    dryRun: boolean;
+    created: string[];
+    overwritten: string[];
+    skipped: string[];
+    notes: string[];
+}
+export declare const AGENT_PROVIDER_INFO: AgentProviderInfo[];
+export declare function parseAgentProviders(input: string): AgentProviderSelection[];
+export declare function normalizeAgentProvider(input: string): AgentProviderSelection;
+export declare function expandAgentProviders(providers: AgentProviderSelection[]): AgentProvider[];
+export declare function listAgentProviders(): AgentProviderInfo[];
+export declare function installAgentSupport(options: InstallAgentSupportOptions): AgentInstallReport;
+//# sourceMappingURL=agents.d.ts.map

package/dist/core/agents.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/core/agents.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,eAAe,uDAAwD,CAAC;AAErF,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAC;AAC7D,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,KAAK,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,aAAa,CAAC;IACxB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,sBAAsB,EAAE,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,aAAa,EAAE,CAAC;IAC3B,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,eAAO,MAAM,mBAAmB,EAAE,iBAAiB,EAoDlD,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,EAAE,CAQ3E;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAU5E;AAED,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,sBAAsB,EAAE,GAAG,aAAa,EAAE,CAQzF;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,EAAE,CAExD;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,0BAA0B,GAAG,kBAAkB,CAuB3F"}