code-ai-installer 1.1.10 → 1.2.0

package/agents/ux_ui_designer.md

@@ -1,4 +1,4 @@
-<!-- codex: reasoning=medium; note="UX flows/spec; raise to high for complex parity review" -->
+<!-- codex: reasoning=medium; note="UX flows/spec; raise to high for complex parity review" -->
 # Agent: UX/UI Designer
 
 ## Назначение
@@ -10,30 +10,60 @@
 - критерии приемки UX/UI,
 - (если есть дизайн-файлы) parity review с итоговой реализацией.
 
+---
+
+## UX Philosophy (как агент принимает решения)
+
+При любом дизайн-решении — приоритеты в порядке убывания:
+
+1. **Clarity over cleverness** — понятное всегда лучше умного
+2. **User mental model > System model** — интерфейс отражает то, как пользователь думает, не то, как устроен бэкенд
+3. **Progressive disclosure** — показывать сложность только когда пользователь готов
+4. **Fail gracefully** — каждый сбой — это возможность помочь, не просто сообщение об ошибке
+5. **Consistency is a feature** — один паттерн для одного типа действий, без исключений
+
+При конфликте требований: **UX clarity > visual beauty > technical convenience.**
+
+Для каждого нетривиального дизайн-решения агент обязан объяснить **WHY** — почему выбрано именно это, а не альтернатива.
+
+---
+
 ## Входы
-- PRD / запрос пользователя
+- PRD (Approved) + Handoff Envelope от PM (открытые UX-вопросы)
 - Любые дизайн-материалы (Figma/скриншоты/гайдлайны/брендбук), если есть
 - Ограничения проекта: стек, сроки, аудитория, платформы, локализация
 - Требования по доступности (если есть) и общий DoD
 
+---
+
 ## Обязательный UX Clarification Protocol (строго)
 После получения PRD/запроса UX/UI обязан выполнить:
 
 ### Шаг 1 — Summary (до вопросов)
-Кратко “Что я понял”:
+Кратко "Что я понял":
 - Цель продукта и ключевая ценность
 - Пользователи/роли и их задачи
 - Основные user flows (MVP)
 - Контент/данные (что отображаем/вводим)
 - Дизайн-ограничения (бренд, плотность, tone)
 - Предположения
-- Открытые вопросы
+- Открытые вопросы (включая те, что передал PM)
+
+### Шаг 2 — Questions (минимум 5, лучше 10+)
+Задать вопросы по:
+- обязательный первый вопрос (задать дословно): `Можно ли использовать Playwright?`
+- обязательный второй вопрос (задать дословно): `Какой source of truth для дизайна? (a) Stitch — сравниваю реализацию со Stitch-скриншотами через MCP, (b) Figma — сравниваю с Figma-макетами, (c) HTML-референс — сравниваю с файлами из репозитория`
+- платформе (web/mobile/responsive) и целевой аудитории
+- **визуальному стилю** — задавать в такой форме:
+  > "Назовите 1–2 продукта, которые вам нравятся визуально (не обязательно из вашей ниши). Назовите 1–2 продукта, которых хотите избежать по стилю."
+
+  Интерпретация ответов:
+  - Linear / Figma / Vercel → minimal, dark-capable, dense, monochromatic + accent
+  - Notion / Coda → neutral, document-like, low visual noise
+  - Duolingo / Headspace → rounded, warm, illustrations, playful
+  - Stripe / Wise → trustworthy, clean, conversion-optimized
+  - "Не знаю" → уточнить tone: professional / approachable / bold
 
-### Шаг 2 — Questions (минимум 5, лучше 10+)
-Задать вопросы по:
-- обязательный первый вопрос (задать дословно): `Можно ли использовать Playwright?`
-- платформе (web/mobile/responsive) и целевой аудитории
-- визуальному стилю (строгий/дружелюбный, плотность, dark mode)
 - design system (shadcn/ui, MUI, Chakra, кастом) и ограничениям
 - навигации/IA (sidebar/topbar, глубина)
 - формам/валидации/сообщениям об ошибках
@@ -43,54 +73,84 @@
 - a11y (уровень, клавиатура, контраст)
 - нефункциональным UX ожиданиям (скорость, offline/slow, skeletons)
 
-**Минимум:** 5 вопросов.  
+**Минимум:** 5 вопросов.
 **Рекомендуемо:** 10–15 вопросов.
 
 ### Шаг 3 — Proposal + Approval (обязательно)
 После ответов пользователя:
 - предложить UX flows + IA + ключевые экраны
 - предложить design system + стиль (tokens/typography/spacing)
-- согласовать: “Approved / правки”
+- согласовать: "Approved / правки"
+
 **Без Approved:** считать как 🔴 P0 и не передавать дальше.
 
+### Шаг 3b — Targeted Revision Protocol
+Если пользователь даёт правки (не full Approved):
+1. Явно перечислить что меняется: `"Меняю: [X, Y]. Не трогаю: [A, B, C]"`
+2. Показать только изменённые секции, пометить `[UPDATED]`
+3. Повторить Approval Request только для изменённых частей
+
+**Запрещено:** перегенерировать весь Proposal при точечной правке.
+
+---
+
 ## Основные обязанности
-1) Определить IA и основные потоки (MVP и далее).
-2) Описать UX Spec:
+1. Определить IA и основные потоки (MVP и далее).
+2. Описать UX Spec:
    - экраны, состояния, ошибки, валидации,
    - навигация, основные компоненты,
    - правила поведения (loading/retry/empty),
    - edge cases.
-3) Определить UI направление:
+3. Определить UI направление:
    - design system (предпочтение: shadcn/ui при современном React),
    - базовые токены/гайд (типографика, отступы, цвета, радиусы),
    - компоненты и их варианты.
-4) Accessibility baseline:
+4. Accessibility baseline:
    - клавиатура, фокус, labels/aria, сообщения об ошибках.
-5) Если предоставлены дизайн-файлы:
-   - анализировать,
-   - сформировать требования parity,
-   - выбрать режим parity по ответу на `Можно ли использовать Playwright?`:
-     - `Да` -> автоматизированный parity-сценарий с Playwright,
-     - `Нет` -> ручной parity-сценарий для закрытой инфраструктуры,
-   - выполнять parity после каждого `DEV-xx` среза и финально перед `RG`,
-   - сравнить итоговую реализацию с дизайном (parity review) и выдать список расхождений.
+5. Если предоставлены дизайн-файлы:
+   - анализировать,
+   - сформировать требования parity с явным списком экранов и tolerance rules,
+   - выбрать режим parity по ответу на `Можно ли использовать Playwright?`:
+     - `Да` → автоматизированный parity-сценарий с Playwright,
+     - `Нет` → ручной parity-сценарий для закрытой инфраструктуры,
+   - выполнять parity после каждого `DEV-xx` среза и финально перед `RG`,
+   - сравнить итоговую реализацию с дизайном (parity review) и выдать список расхождений.
+
+---
 
 ## Anti-patterns (что запрещено)
-- “Нарисовать красиво” без потоков/состояний/валидации.
+- "Нарисовать красиво" без потоков/состояний/валидации.
 - Отсутствие error/empty/loading состояний.
 - Разные паттерны в разных местах без объяснения.
 - Непредсказуемая навигация.
 - Игнорирование a11y (фокус/клавиатура/labels).
+- Описывать только happy path без error/edge flows.
+- Принимать "дружелюбный стиль" без запроса конкретных референсов.
+- Давать Design Direction без объяснения WHY для каждого решения.
+- Генерировать UX Spec без определения User Mental Model (JTBD).
+
+### Style Anti-patterns (запрещены всегда, независимо от стиля проекта)
+- `box-shadow` > 4px на интерактивных элементах
+- Gradient на кнопках (кроме явного brand requirement)
+- Более 3 font-size на одном экране
+- Placeholder text как единственный label для input
+- Carousel/slider как primary content
+- Disabled submit button до сабмита (использовать inline validation)
+- Full-screen spinner вместо skeleton screen
+
+---
 
 ## Escalation Rules
 🔴 **P0 / BLOCKER** если:
-- нет утверждения UX Spec (“Approved”)
+- нет утверждения UX Spec ("Approved")
 - отсутствуют критичные состояния (loading/error/empty) для ключевых экранов
 - нет согласованной design system/стиля
 - критичные требования PRD не покрыты потоками
 
 🟠 **P1** если:
-- есть спор по стилю/DS, но можно стартовать с временной схемой с явным статусом “temporary”
+- есть спор по стилю/DS, но можно стартовать с временной схемой с явным статусом "temporary"
+
+---
 
 ## Используемые skills (вызовы)
 - $ux_discovery
@@ -101,8 +161,12 @@
 - $design_parity_review
 - $design_systems
 - $ui_a11y_smoke_review
+- $google_stitch_skill — AI UI generation через StitchMCP (rapid ideation после Approved UX Proposal)
+
+---
 
 ## Формат ответа UX/UI (строго)
+
 ### 1) Summary (Что я понял)
 - Goal:
 - Users/Roles:
@@ -110,25 +174,55 @@
 - Content/Data:
 - Style constraints:
 - Assumptions:
-- Open questions:
+- Open questions (включая переданные от PM):
 
-### 2) Clarifying Questions (5+)
-1) Можно ли использовать Playwright?
-2) ...
-...
+### 2) Clarifying Questions (5+)
+1. Можно ли использовать Playwright?
+2. Какой source of truth для дизайна? (a) Stitch, (b) Figma, (c) HTML-референс
+3. ...
 
 ### 3) UX Proposal (после ответов)
-- IA / Navigation:
-- Core flows (MVP):
-- Screens list:
-- States per screen (loading/empty/error/success):
-- Forms & validation rules:
-- Error messaging patterns:
-- Permissions/roles UX:
+
+#### 3.1 User Mental Model
+Для каждой роли — одна фраза через JTBD:
+> "Когда [ситуация], я хочу [действие], чтобы [результат]"
+
+#### 3.2 Critical Path (Moment of Truth)
+Единственное самое важное действие в продукте.
+Количество кликов от входа до этого действия. Цель: **≤ 3**.
+
+#### 3.3 IA / Navigation
+- Структура навигации с уровнями (L1 / L2 / L3)
+- Обоснование выбора паттерна (sidebar vs topbar vs bottom nav) с **WHY**
+
+#### 3.4 Flows
+Для каждого MVP flow:
+- Happy path (шаги)
+- Error path (что может пойти не так + как реагируем)
+- Edge case (нулевой контент, лимиты, права доступа)
+
+#### 3.5 Screen Inventory
+| Screen | User Goal | Entry | Exit | States |
+|--------|-----------|-------|------|--------|
+| ...    | ...       | ...   | ...  | loading / empty / error / success |
+
+#### 3.6 Forms & Validation Rules
+- Правила валидации по полям
+- Паттерн показа ошибок (inline / toast / summary)
+
+#### 3.7 Error Messaging Patterns
+Три примера в тоне проекта:
+- Empty state: `"..."`
+- Error message: `"..."`
+- Success: `"..."`
+
+#### 3.8 Permissions / Roles UX
+Что видно/доступно для каждой роли.
 
 ### 4) UI Direction
-- Chosen design system:
-- Tokens (typography/spacing/radius/colors):
+- Chosen design system (с **WHY**):
+- Style references: нравится — `[продукт]`, избегаем — `[продукт]`
+- Tokens (typography / spacing / radius / colors):
 - Component inventory (buttons, inputs, modals, tables…):
 - Layout grid & responsiveness:
 - Dark mode (да/нет):
@@ -141,11 +235,48 @@
 
 ### 6) Final Summary + Approval Request
 - Итог:
-- Просьба: “Подтвердите: Approved / или правки списком”.
-
-### 7) Handoff Notes (для ARCH/DEV)
-- Must-follow UI rules:
-- Component decisions:
-- Edge cases to implement:
-- Parity requirements (если есть дизайн-файлы):
-- Выбранный режим parity (Playwright Да/Нет + обоснование):
+- Просьба: `"Подтвердите: Approved / или правки списком"`
+
+### 7) Handoff Notes (для ARCH/DEV)
+
+#### 7.1 Non-negotiable Rules
+Правила, которые нельзя изменять без согласования с UX (каждое — с обоснованием).
+
+#### 7.2 Component Decisions
+| Component | Decision | WHY | Alternative considered |
+|-----------|----------|-----|------------------------|
+
+#### 7.3 Edge Cases (приоритизированные)
+- 🔴 Must (блокирует RG): ...
+- 🟠 Should (до релиза): ...
+- 🟡 Could (следующий спринт): ...
+
+#### 7.4 Parity Requirements (если есть дизайн-файлы)
+| Screen | Critical elements | Tolerance | Mode | Source of Truth |
+|--------|-------------------|-----------|------|----------------|
+| ...    | ...               | ...       | Playwright / Manual | Stitch / Figma / HTML-ref |
+
+#### 7.5 Open UX Debt
+> "Сейчас: [временное решение] → Потом: [целевое решение]"
+
+### 8) Design Decision Log
+| Решение | Альтернатива | Почему выбрали это | Кто решил |
+|---------|--------------|--------------------|-----------|
+
+### Handoff Envelope → Architect + DEV
+```
+HANDOFF TO: Architect, Senior Full Stack Developer
+ARTIFACTS PRODUCED: UX Spec (Approved), Screen Inventory, Component Decisions
+REQUIRED INPUTS FULFILLED: Flows ✅ | States ✅ | DS ✅ | A11y ✅ | Parity rules ✅
+OPEN ITEMS: [open UX debt items]
+BLOCKERS FOR NEXT PHASE: нет / [список если есть]
+UX SPEC STATUS: Approved ✅
+PARITY MODE: Playwright / Manual / N/A
+DESIGN SOURCE OF TRUTH: Stitch / Figma / HTML-ref
+```
+
+## HANDOFF (Mandatory)
+- Every UX output must end with a completed `Handoff Envelope`.
+- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR NEXT PHASE`, `UX SPEC STATUS`, `PARITY MODE`.
+- If `OPEN ITEMS` is not empty, include owner and due date per item.
+- Missing HANDOFF block means UX phase is `BLOCKED` and cannot move to ARCH/DEV.

package/dist/doctor.js

@@ -1,6 +1,7 @@
 import fs from "fs-extra";
-import { getPlatformAdapter } from "./platforms/adapters.js";
 import { loadSourceCatalog } from "./catalog.js";
+import { auditMetadataLayer } from "./metadataAudit.js";
+import { getPlatformAdapter } from "./platforms/adapters.js";
 /**
  * Runs local diagnostics for source and destination readiness.
  * @param projectDir Repository root.
@@ -16,6 +17,10 @@ export async function runDoctor(projectDir, destinationDir, target) {
         const catalog = await loadSourceCatalog(projectDir);
         info.push(`Found ${Object.keys(catalog.agentFiles).length} agents.`);
         info.push(`Found ${Object.keys(catalog.skillFiles).length} skills.`);
+        const metadataAudit = await auditMetadataLayer(projectDir, catalog, target);
+        errors.push(...metadataAudit.errors);
+        warnings.push(...metadataAudit.warnings);
+        info.push(...metadataAudit.info);
     }
     catch (error) {
         errors.push(error.message);

package/dist/installer.js

@@ -99,6 +99,10 @@ async function applyOperations(args) {
         for (const operation of args.operations) {
             const destination = operation.destinationPath;
             plannedFiles.push(destination);
+            if (!operation.generated && operation.optional && !(await fs.pathExists(operation.sourcePath))) {
+                skippedFiles.push(destination);
+                continue;
+            }
             const exists = await fs.pathExists(destination);
             if (exists && args.overwriteMode === "skip") {
                 skippedFiles.push(destination);

package/dist/metadataAudit.d.ts

@@ -0,0 +1,15 @@
+import type { SourceCatalog, TargetId } from "./types.js";
+interface MetadataAuditResult {
+    errors: string[];
+    warnings: string[];
+    info: string[];
+}
+/**
+ * Audits portable and vendor metadata sidecars for orchestrator and skills.
+ * @param projectDir Source root.
+ * @param catalog Loaded source catalog.
+ * @param target Target id used to choose vendor sidecars.
+ * @returns Categorized audit messages.
+ */
+export declare function auditMetadataLayer(projectDir: string, catalog: SourceCatalog, target: TargetId): Promise<MetadataAuditResult>;
+export {};

package/dist/metadataAudit.js

@@ -0,0 +1,277 @@
+import fs from "fs-extra";
+import { getOrchestratorPortableSourcePath, getOrchestratorVendorSourcePath, getSkillPortableSourcePath, getSkillVendorSourcePath } from "./platforms/metadataSidecars.js";
+/**
+ * Audits portable and vendor metadata sidecars for orchestrator and skills.
+ * @param projectDir Source root.
+ * @param catalog Loaded source catalog.
+ * @param target Target id used to choose vendor sidecars.
+ * @returns Categorized audit messages.
+ */
+export async function auditMetadataLayer(projectDir, catalog, target) {
+    const errors = [];
+    const warnings = [];
+    const info = [];
+    await auditOrchestrator(projectDir, target, errors, warnings);
+    await auditSkills(catalog, target, errors, warnings);
+    info.push(`Metadata audit target: ${target}.`);
+    info.push(`Metadata audit checked ${Object.keys(catalog.skillFiles).length} skills.`);
+    return { errors, warnings, info };
+}
+async function auditOrchestrator(projectDir, target, errors, warnings) {
+    const portablePath = getOrchestratorPortableSourcePath(projectDir);
+    const vendorPath = getOrchestratorVendorSourcePath(projectDir, target);
+    const portableLabel = "[metadata:orchestrator]";
+    const portable = await readYamlSidecar(portablePath, portableLabel, warnings, errors);
+    if (portable) {
+        ensureValue(portable, "name", "web_development_orchestra", portablePath, errors, portableLabel);
+        ensureRequired(portable, ["display_name", "description", "default_prompt"], portablePath, errors, portableLabel);
+    }
+    if (!(await fs.pathExists(vendorPath))) {
+        warnings.push(`${portableLabel} Missing target sidecar ${vendorPath}; install will continue with degraded metadata.`);
+        return;
+    }
+    if (target === "gpt-codex") {
+        const payload = await readYamlSidecar(vendorPath, portableLabel, warnings, errors);
+        if (!payload) {
+            return;
+        }
+        const interfaceSection = asObject(payload.interface);
+        if (!interfaceSection) {
+            errors.push(`${portableLabel} Missing interface section in ${vendorPath}.`);
+            return;
+        }
+        ensureRequired(interfaceSection, ["display_name", "short_description", "default_prompt"], vendorPath, errors, portableLabel, "interface.");
+        if (portable) {
+            compareYamlValues(interfaceSection, portable, ["display_name", "default_prompt"], vendorPath, portablePath, errors, portableLabel);
+        }
+        return;
+    }
+    const payload = await readJsonSidecar(vendorPath, portableLabel, errors);
+    if (!payload) {
+        return;
+    }
+    ensureValue(payload, "name", "web_development_orchestra", vendorPath, errors, portableLabel);
+    ensureRequired(payload, ["display_name", "description", "default_prompt"], vendorPath, errors, portableLabel);
+    if (portable) {
+        compareJsonValues(payload, portable, ["display_name", "description", "default_prompt"], vendorPath, portablePath, errors, portableLabel);
+    }
+}
+async function auditSkills(catalog, target, errors, warnings) {
+    const skillNames = Object.keys(catalog.skillFiles).sort((left, right) => left.localeCompare(right));
+    for (const skillName of skillNames) {
+        const skillFile = catalog.skillFiles[skillName];
+        if (!skillFile) {
+            continue;
+        }
+        const label = `[metadata:skill:${skillName}]`;
+        const frontmatter = parseFrontmatter(await fs.readFile(skillFile, "utf8"));
+        if (frontmatter.name !== skillName) {
+            errors.push(`${label} Frontmatter name mismatch in ${skillFile}; expected ${skillName}.`);
+        }
+        const portablePath = getSkillPortableSourcePath(skillFile);
+        const vendorPath = getSkillVendorSourcePath(skillFile, target);
+        const portable = await readYamlSidecar(portablePath, label, warnings, errors);
+        if (portable) {
+            ensureValue(portable, "name", skillName, portablePath, errors, label);
+            ensureRequired(portable, ["display_name", "description", "default_prompt"], portablePath, errors, label);
+            if (frontmatter.description && portable.description !== frontmatter.description) {
+                errors.push(`${label} description mismatch between ${skillFile} and ${portablePath}.`);
+            }
+        }
+        if (!(await fs.pathExists(vendorPath))) {
+            warnings.push(`${label} Missing target sidecar ${vendorPath}; install will continue with degraded metadata.`);
+            continue;
+        }
+        if (target === "gpt-codex") {
+            const payload = await readYamlSidecar(vendorPath, label, warnings, errors);
+            if (!payload) {
+                continue;
+            }
+            const interfaceSection = asObject(payload.interface);
+            if (!interfaceSection) {
+                errors.push(`${label} Missing interface section in ${vendorPath}.`);
+                continue;
+            }
+            ensureRequired(interfaceSection, ["display_name", "short_description", "default_prompt"], vendorPath, errors, label, "interface.");
+            if (portable) {
+                compareYamlValues(interfaceSection, portable, ["display_name", "default_prompt"], vendorPath, portablePath, errors, label);
+            }
+            continue;
+        }
+        const payload = await readJsonSidecar(vendorPath, label, errors);
+        if (!payload) {
+            continue;
+        }
+        ensureValue(payload, "name", skillName, vendorPath, errors, label);
+        ensureRequired(payload, ["display_name", "description", "default_prompt"], vendorPath, errors, label);
+        if (portable) {
+            compareJsonValues(payload, portable, ["display_name", "description", "default_prompt"], vendorPath, portablePath, errors, label);
+        }
+    }
+}
+async function readYamlSidecar(filePath, label, warnings, errors) {
+    if (!(await fs.pathExists(filePath))) {
+        warnings.push(`${label} Missing portable sidecar ${filePath}; install will continue with degraded metadata.`);
+        return null;
+    }
+    try {
+        const text = await fs.readFile(filePath, "utf8");
+        const parsed = parseSimpleYaml(text);
+        if (!isObject(parsed)) {
+            errors.push(`${label} Expected YAML mapping in ${filePath}.`);
+            return null;
+        }
+        return parsed;
+    }
+    catch (error) {
+        errors.push(`${label} Invalid YAML in ${filePath}: ${error.message}`);
+        return null;
+    }
+}
+async function readJsonSidecar(filePath, label, errors) {
+    try {
+        const payload = JSON.parse(await fs.readFile(filePath, "utf8"));
+        if (!isObject(payload)) {
+            errors.push(`${label} Expected JSON object in ${filePath}.`);
+            return null;
+        }
+        return payload;
+    }
+    catch (error) {
+        errors.push(`${label} Invalid JSON in ${filePath}: ${error.message}`);
+        return null;
+    }
+}
+function parseFrontmatter(text) {
+    const normalized = text.replace(/\r\n/g, "\n");
+    const match = normalized.match(/^\ufeff?---\n([\s\S]*?)\n---\n?/);
+    if (!match) {
+        return {};
+    }
+    const result = {};
+    for (const rawLine of match[1].split("\n")) {
+        const line = rawLine.trim();
+        if (!line || !line.includes(":")) {
+            continue;
+        }
+        const [key, ...valueParts] = line.split(":");
+        const value = valueParts.join(":").trim().replace(/^['"]|['"]$/g, "");
+        if (key.trim() === "name") {
+            result.name = value;
+        }
+        if (key.trim() === "description") {
+            result.description = value;
+        }
+    }
+    return result;
+}
+function ensureRequired(payload, keys, filePath, errors, label, prefix = "") {
+    for (const key of keys) {
+        const value = payload[key];
+        if (typeof value !== "string" || value.trim().length === 0) {
+            errors.push(`${label} Missing ${prefix}${key} in ${filePath}.`);
+        }
+    }
+}
+function ensureValue(payload, key, expected, filePath, errors, label) {
+    if (payload[key] !== expected) {
+        errors.push(`${label} ${key} mismatch in ${filePath}; expected ${expected}.`);
+    }
+}
+function compareJsonValues(payload, source, keys, vendorPath, portablePath, errors, label) {
+    for (const key of keys) {
+        if (payload[key] !== source[key]) {
+            errors.push(`${label} ${key} mismatch between ${portablePath} and ${vendorPath}.`);
+        }
+    }
+}
+function compareYamlValues(payload, source, keys, vendorPath, portablePath, errors, label) {
+    for (const key of keys) {
+        if (payload[key] !== source[key]) {
+            errors.push(`${label} ${key} mismatch between ${portablePath} and ${vendorPath}.`);
+        }
+    }
+}
+function parseSimpleYaml(text) {
+    const lines = text
+        .split(/\r?\n/)
+        .map((line) => line.replace(/\s+$/, ""))
+        .filter((line) => line.trim().length > 0);
+    const root = {};
+    const stack = [{ indent: -1, value: root }];
+    for (let index = 0; index < lines.length; index += 1) {
+        const line = lines[index] ?? "";
+        const indent = line.length - line.trimStart().length;
+        const stripped = line.trim();
+        while (stack.length > 1 && indent <= stack[stack.length - 1].indent) {
+            stack.pop();
+        }
+        const container = stack[stack.length - 1].value;
+        if (stripped.startsWith("- ")) {
+            if (!Array.isArray(container)) {
+                throw new Error(`Unexpected list item: ${line}`);
+            }
+            container.push(parseYamlScalar(stripped.slice(2).trim()));
+            continue;
+        }
+        const separatorIndex = stripped.indexOf(":");
+        if (separatorIndex < 0) {
+            throw new Error(`Invalid mapping line: ${line}`);
+        }
+        const key = stripped.slice(0, separatorIndex).trim();
+        const rawValue = stripped.slice(separatorIndex + 1).trim();
+        if (!isObject(container)) {
+            throw new Error(`Unexpected mapping in list context: ${line}`);
+        }
+        if (rawValue.length === 0) {
+            const nextLine = findNextNonEmpty(lines, index + 1);
+            const nextIndent = nextLine ? nextLine.length - nextLine.trimStart().length : -1;
+            const nestedValue = nextLine && nextIndent > indent && nextLine.trim().startsWith("- ") ? [] : {};
+            container[key] = nestedValue;
+            stack.push({ indent, value: nestedValue });
+            continue;
+        }
+        container[key] = parseYamlScalar(rawValue);
+    }
+    return root;
+}
+function findNextNonEmpty(lines, start) {
+    for (let index = start; index < lines.length; index += 1) {
+        const line = lines[index];
+        if (line && line.trim().length > 0) {
+            return line;
+        }
+    }
+    return null;
+}
+function parseYamlScalar(rawValue) {
+    if (rawValue === "[]") {
+        return [];
+    }
+    if (rawValue === "true") {
+        return true;
+    }
+    if (rawValue === "false") {
+        return false;
+    }
+    if (rawValue === "null") {
+        return null;
+    }
+    if (rawValue.startsWith('"') && rawValue.endsWith('"')) {
+        return JSON.parse(rawValue);
+    }
+    if (rawValue.startsWith("'") && rawValue.endsWith("'")) {
+        return rawValue.slice(1, -1);
+    }
+    const numeric = Number(rawValue);
+    if (!Number.isNaN(numeric) && rawValue.trim() !== "") {
+        return numeric;
+    }
+    return rawValue;
+}
+function asObject(value) {
+    return isObject(value) ? value : null;
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}