code-ai-installer 2.4.1 → 3.0.0

package/AGENTS.md

@@ -1,199 +0,0 @@
-# AGENTS.md — Оркестр веб-разработки
-
-> [!CAUTION]
-> **🔴 АБСОЛЮТНОЕ ПРАВИЛО №1:** Пайплайн запрещено пропускать. Без исключений.
-> Полный протокол: [pipeline-rules.md](.agents/workflows/pipeline-rules.md)
-> Каждый гейт → читать агента → deliverable → HANDOFF → **User sign-off** → следующий гейт.
-
-## Источник правды по ролям
-Роли описаны в:
-- agents/conductor.md
-- agents/product_manager.md
-- agents/ux_ui_designer.md
-- agents/architect.md
-- agents/devops.md
-- agents/senior_full_stack.md
-- agents/reviewer.md
-- agents/tester.md
-
-При работе следуй этим ролям. Если нужно — открывай соответствующий файл роли и применяй.
-
----
-
-## Skills (явно вызывай)
-Используй skills (папки с `SKILL.md`). Полный список:
-
-### Core / Orchestration
-- $board
-- $handoff
-- $memory
-- $gates
-- $release-gate
-- $release-gate-checklist-template
-
-### Product Management
-- $pm-interview
-- $pm-prd
-- $pm-backlog
-
-### UX/UI / Design
-- $ux-discovery
-- $ux-spec
-- $ui-inventory
-- $a11y-baseline
-- $design-intake
-- $design-parity-review
-- $design-systems
-- $ui-a11y-smoke-review
-- $golden-canon-grid
-- $google-stitch-skill
-
-### Architecture
-- $current-state-analysis
-- $system-design-checklist
-- $architecture-doc
-- $architecture-compliance-review
-- $lava-flow-legacy-detection
-- $design-patterns-reference
-- $adr-log
-- $api-contracts
-- $data-model
-- $threat-model-baseline
-- $observability-plan
-- $deployment-ci-plan
-- $docker-kubernetes-architecture
-- $k8s-manifests-conventions
-- $n8n-pinecone-qdrant-supabase
-- $wix-self-hosted-embedded-script
-- $wix-iframe-sdk
-- $react-15-3-wix-iframe (условно, только если Wix iFrame / React 15.3)
-
-### Development (Senior Full Stack)
-- $tdd-workflow
-- $testing-strategy-js
-- $tests-quality-review
-- $es2025-beast-practices
-- $typescript-beast-practices
-- $react-beast-practices
-- $tanstack-beast-practices
-- $state-zustand-beast-practices
-- $state-rtk-beast-practices
-- $styling-css-stack
-- $design-systems
-- $tooling-bun-biome
-- $node-express-beast-practices
-- $go-beast-practices
-- $security-baseline-dev
-- $lava-flow-legacy-detection
-- $observability-logging
-- $dev-reference-snippets
-- $mongodb-mongoose-best-practices
-- $n8n-pinecone-qdrant-supabase
-- $wix-self-hosted-embedded-script
-- $wix-iframe-sdk
-- $react-15-3-wix-iframe (условно, только если Wix iFrame / React 15.3)
-- $tailwind-beast-practices
-
-### Review (Best Practices + Security)
-- $code-review-checklist
-- $api-contract-compliance-review
-- $architecture-compliance-review
-- $tests-quality-review
-- $security-review
-- $security-review-baseline
-- $cloud-infrastructure-security
-- $dependency-supply-chain-review
-- $observability-review
-- $performance-review-baseline
-- $lava-flow-legacy-detection
-- $review-reference-snippets
-
-### DevOps / Infrastructure
-- $deployment-ci-plan
-- $docker-kubernetes-architecture
-- $k8s-manifests-conventions
-- $cloud-infrastructure-security
-- $observability-logging
-- $security-baseline-dev
-- $compass-mongodb
-
-### Cross-cutting / Quality (все агенты, все домены)
-- $karpathy-guidelines
-
-### Testing (QA)
-- $qa-test-plan
-- $qa-manual-run
-- $qa-browser-testing
-- $qa-api-contract-tests
-- $qa-security-smoke-tests
-- $qa-ui-a11y-smoke
-- $qa-e2e-playwright
-- $qa-regression-baseline
-
-> [!IMPORTANT]
-> **Аудит скиллов:** при проверке синхронизации скиллов между агентами и AGENTS.md **всегда** использовать `view_file` для чтения секции «Используемые skills» в каждом агенте. Не полагаться на `grep` с паттерном `$` — символ `$` некорректно обрабатывается ripgrep/PowerShell, а лимит в 50 результатов может отсечь часть агентов.
-
----
-
-## Гейты (Pipeline) — 3 режима
-
-### 🔵 Full Pipeline (фичи, рефакторинг) — `/start-task`
-PM(PRD) → UX(UX Spec) → ARCH(Architecture/ADR/Contracts) → DEV(TDD) → REV(Security/Best) → OPS(Build/Deploy) → TEST(Test plan/report) → RG(Release Gate)
-
-### 🟢 Bugfix Pipeline (баги) — `/bugfix`
-CONDUCTOR → DEV(TDD) → REV(Review) → TEST(Verification + GO/NO-GO)
-
-### 🟡 Hotfix Pipeline (мелочи, blast radius ≈ 0) — `/hotfix`
-CONDUCTOR → DEV+TEST(Fix + self-check + GO/NO-GO)
-
-> **Выбор режима:** Conductor определяет по Decision Tree (см. `agents/conductor.md`).
-> Approved обязателен на **каждом** гейте, в любом режиме.
-
----
-
-## Обязательное правило качества (Karpathy Guidelines)
-
-**$karpathy-guidelines обязателен для всех агентов во всех доменах.** Перед любой нетривиальной задачей:
-1. **Сначала думай, потом делай** — явно называй предположения, спрашивай при неопределённости.
-2. **Делай только то, что просили** — минимум, решающий задачу. Ничего лишнего.
-3. **Правь точечно** — трогай только то, что необходимо для задачи.
-4. **Работай от результата** — определи проверяемые критерии успеха до начала работы.
-
----
-
-## Обязательное правило документации функций
-- Для всех функций в кодовой базе использовать JSDoc-блок в формате:
-
-```js
-/**
- * Считает сумму двух чисел.
- * @param {number} a - Первое число.
- * @param {number} b - Второе число.
- * @returns {number} Сумма a и b.
- */
-function add(a, b) {
-    return a + b;
-}
-```
-
-- Требование обязательное для DEV и REV этапов.
-
----
-
-## Обязательное правило перезагрузки Docker-контейнеров
-- Для всех изменений в кодовой базе DevOps обязан автоматически перезапускать затронутый сервис в Docker до передачи в REVIEW/TEST.
-- Базовое правило команд:
-  - Изменения только runtime-кода: `docker compose restart <service>`.
-  - Изменения `Dockerfile`/зависимостей/сборки/compose-конфига: `docker compose up -d --build <service>`.
-- При изменениях в прокси/шлюзе/общей маршрутизации дополнительно перезапускать `gateway`.
-- DevOps обязан приложить в отчёт доказательства:
-  - какие сервисы перезапущены,
-  - какие команды выполнены,
-  - результат health/smoke после перезапуска.
-
----
-
-## Обязательное подтверждение команд
-- **Never auto-run commands that modify files. Always ask for confirmation.**
-- Любая команда, изменяющая файлы (запись, удаление, перемещение, установка зависимостей, сборка), должна выполняться с `SafeToAutoRun: false`.
-

package/AGENTS.yaml

@@ -1,109 +0,0 @@
-version: 1
-name: "web_development_orchestra"
-display_name: "AGENTS.md — Оркестр веб-разработки"
-description: "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки."
-default_prompt: "Используй AGENTS.md, когда задача требует оркестрации ролей, skills и delivery-гейтов репозитория."
-triggers:
-  - "AGENTS.md"
-  - "AGENTS.md — Оркестр веб-разработки"
-  - "оркестратор"
-  - "оркестр веб-разработки"
-  - "Базовый контракт оркестрации ролей, skills и delivery-gates для веб-разработки"
-  - "conductor"
-roles:
-  - "architect"
-  - "conductor"
-  - "devops"
-  - "product_manager"
-  - "reviewer"
-  - "senior_full_stack"
-  - "tester"
-  - "ux_ui_designer"
-skills:
-  - "a11y-baseline"
-  - "adr-log"
-  - "api-contract-compliance-review"
-  - "api-contracts"
-  - "architecture-compliance-review"
-  - "architecture-doc"
-  - "board"
-  - "cloud-infrastructure-security"
-  - "code-review-checklist"
-  - "current-state-analysis"
-  - "data-model"
-  - "dependency-supply-chain-review"
-  - "deployment-ci-plan"
-  - "design-intake"
-  - "design-parity-review"
-  - "design-patterns-reference"
-  - "design-systems"
-  - "dev-reference-snippets"
-  - "docker-kubernetes-architecture"
-  - "es2025-beast-practices"
-  - "gates"
-  - "go-beast-practices"
-  - "golden-canon-grid"
-  - "google-stitch-skill"
-  - "handoff"
-  - "k8s-manifests-conventions"
-  - "memory"
-  - "mongodb-mongoose-best-practices"
-  - "n8n-pinecone-qdrant-supabase"
-  - "node-express-beast-practices"
-  - "observability-logging"
-  - "observability-plan"
-  - "observability-review"
-  - "performance-review-baseline"
-  - "pm-backlog"
-  - "pm-interview"
-  - "pm-prd"
-  - "qa-api-contract-tests"
-  - "qa-browser-testing"
-  - "qa-e2e-playwright"
-  - "qa-manual-run"
-  - "qa-regression-baseline"
-  - "qa-security-smoke-tests"
-  - "qa-test-plan"
-  - "qa-ui-a11y-smoke"
-  - "react-15-3-wix-iframe"
-  - "react-beast-practices"
-  - "release-gate"
-  - "release-gate-checklist-template"
-  - "review-reference-snippets"
-  - "security-baseline-dev"
-  - "security-review"
-  - "security-review-baseline"
-  - "state-rtk-beast-practices"
-  - "state-zustand-beast-practices"
-  - "styling-css-stack"
-  - "system-design-checklist"
-  - "tailwind-beast-practices"
-  - "tanstack-beast-practices"
-  - "tdd-workflow"
-  - "testing-strategy-js"
-  - "tests-quality-review"
-  - "threat-model-baseline"
-  - "tooling-bun-biome"
-  - "typescript-beast-practices"
-  - "ui-a11y-smoke-review"
-  - "ui-inventory"
-  - "ux-discovery"
-  - "ux-spec"
-  - "wix-iframe-sdk"
-  - "wix-self-hosted-embedded-script"
-pipeline:
-  - "PM(PRD)"
-  - "UX(UX Spec)"
-  - "ARCH(Architecture/ADR/Contracts)"
-  - "DEV(TDD)"
-  - "REV(Security/Best)"
-  - "TEST(Test plan/report)"
-  - "RG(Release Gate)"
-invocation:
-  explicit: false
-  implicit: true
-localization:
-  default_locale: "ru"
-  available_locales:
-    - "ru"
-    - "en"

package/CONTEXT.md

@@ -1,88 +0,0 @@
-# Обзор проекта
-
-| Поле | Значение |
-|------|----------|
-| **Название** | code-ai-installer |
-| **Описание** | CLI для установки AI-агентов и скилов для множества AI-ассистентов |
-| **Текущая фаза** | v2.4.1 — Domain karpathy fix + Gemini agent rename |
-| **Дата создания** | 2026-03-01 |
-| **Последнее обновление** | 2026-04-29 |
-
----
-
-## Результаты пайплайна
-
-| Gate | Статус | Ключевой результат | Дата |
-|------|--------|---------------------|------|
-| Conductor | ✅ | Master Checklist, 16 задач, 3-session plan | 2026-04-03 |
-| PM (PRD) | ✅ | PRD v1.0 — docs/prd-domains-v1.md | 2026-04-03 |
-| UX/UI | ✅ | UX Spec v1.0 — docs/ux-spec-domains-v1.md | 2026-04-03 |
-| Architect | ✅ | Architecture Doc v1.0 — docs/architecture-domains-v1.md | 2026-04-04 |
-| DevOps | ✅ | OPS-01 report (CLI tool, N/A containers) | 2026-04-04 |
-| Dev (TDD) | ✅ | 4 slices: types, domainResolver, installer, content domain | 2026-04-04 |
-| Reviewer | ✅ | REV-01 GO (0 P0, JSDoc 14/14) | 2026-04-04 |
-| Tester | ✅ | QA-01 PASS (93/93 tests, 8/8 CLI smoke) | 2026-04-04 |
-| Release Gate | ✅ | RG-01 GO | 2026-04-04 |
-
----
-
-## Ключевые решения (ADR)
-
-| ID | Решение | Обоснование | Статус |
-|----|---------|-------------|--------|
-| ADR-001 | Domain filesystem layout: domains/<id>/ с полной структурой + domain.json | Полная изоляция, стандартная структура, независимое тестирование | Accepted |
-| ADR-002 | Backward compat: two-phase detection (sourceResolver + domainResolver) | Zero-config upgrade, два code path | Accepted |
-| ADR-003 | Domain metadata via domain.json (zod-validated) | Structured, extensible, не зависит от markdown parsing | Accepted |
-| ADR-004 | Separate domainResolver.ts module (SRP) | Clean API, testable, sourceResolver остаётся про package root | Accepted |
-| ADR-005 | State file naming: target--domain.json | Backward compat, flat files, safe separator | Accepted |
-
----
-
-## Текущее состояние
-
-### Сделано
-- v2.0.0 Domain System полностью реализован
-- DomainId strict enum + zod validation
-- domainResolver.ts: listDomains, resolveDomainSourceRoot, normalizeDomain
-- sourceResolver.ts: расширена isValidSourceRoot для domains/ layout
-- installer.ts: domain-aware state file naming (target--domain.json) + Gemini prompt.md → `<agent>.md` migration (v2.4.1)
-- index.ts: --domain flag на всех CLI командах, wizard domain step
-- domains/development/: 8 agents, 72 skills (включая karpathy-guidelines), 5 workflows
-- domains/content/: 6 agents, 35 skills, 4 workflows
-- domains/analytics/: 8 agents, 24 skills
-- domains/product/: 10 agents, 33 skills
-- Локали en/ для всех 4 доменов
-- karpathy-guidelines: cross-cutting skill, mandatory for all agents in all domains (v2.4.1 fix: добавлен в `domains/<id>/`)
-- Gemini layout: `<agentsDir>/<agentName>/<agentName>.md` (v2.4.1, было `prompt.md` до v2.4.0)
-- agentSkillResolution регрессионный тест: ловит broken `$skill-name` ссылки из агентов
-- package.json: v2.4.1, "domains" в files array
-- 102 теста, все GREEN
-- Build (tsc): 0 errors
-
-### В процессе
-- Нет активных задач
-
-### Заблокировано
-- Нет блокеров
-
----
-
-## Открытые вопросы
-
-| ID | Вопрос | Владелец | Дедлайн | Статус |
-|----|--------|----------|---------|--------|
-| Q-001 | Content domain metadata sidecars (skill.yaml, vendor JSON) | DEV | post-MVP | Open |
-| Q-002 | npm package size с domains/ | DevOps | post-MVP | Open |
-
----
-
-## История сессий
-
-| Сессия | Дата | Краткий итог | Артефакты |
-|--------|------|--------------|-----------|
-| Session 1 | 2026-04-03 | Gates 0-1: Conductor + PM (PRD) | docs/prd-domains-v1.md, docs/session-1-summary.md |
-| Session 2 | 2026-04-03 | Gates 2-3: UX + ARCH | docs/ux-spec-domains-v1.md, docs/architecture-domains-v1.md, docs/session-2-summary.md |
-| Session 3 | 2026-04-04 | Gates 4-8: DEV + REV + OPS + TEST + RG | src/domainResolver.ts, domains/, package.json v2.0.0 |
-| Hotfix v2.0.2 | 2026-04-08 | Bugfix + защита от регрессии: (1) 30 content-domain скиллов имели расхождения `description` между SKILL.md frontmatter и портабл/вендор sidecar — приведено к SKILL.md (источник истины), 150 файлов обновлено. (2) 4 скилла (`email-engagement-tiers`, `google-stitch-content`, `mailerlite-email-ops`, `marketing-psychology`) шипились без sidecar — сгенерированы 24 файла (skill.yaml + claude/copilot/gemini/qwen.json + openai.yaml). (3) Test gap: единственный test против реальных файлов смотрел только на легаси-корень репо (= development domain), content domain был слепой. Добавлен `metadataAudit.test.ts → "should pass audit for every domain × every target"` — итерируется по `listDomains() × 5 targets`. (4) `package.json prepack` теперь запускает `doctor:all` (`development` + `content`) — `npm publish` не сможет запаковать сломанный пакет. 94/94 теста зелёные, doctor PASS на всех 5 targets без warnings. **Не публиковался отдельно — все изменения вошли в v2.1.0.** | См. v2.1.0 |
-| Feature v2.1.0 | 2026-04-08 | **Socket.dev Supply-Chain Integration**. Bugfix-pipeline (CONDUCTOR → ARCH lite → DEV → REV → TEST) с user sign-off на каждом гейте. Изменения: (1) `dependency-supply-chain-review` skill v2.0 — добавлена секция «0. Prerequisites» с обязательным `socket-mcp` (HTTP по умолчанию, stdio для paid аккаунтов), detection protocol, degraded mode protocol; новая секция «9. Socket.dev Integration» с `depscore` workflow и threshold matrix (supply_chain≥0.75, vulnerability≥0.80, license≥0.50); checklist 3.2 расширен DEP-05a/05b/05c/05d (P0); Output Template обновлён блоком Socket.dev Audit. (2) Reviewer agent: добавлен socket-mcp в Входы, обязательный принцип supply chain через socket.dev в Главные принципы, поле `SOCKET.DEV MODE` в Handoff Envelope. (3) Senior Full Stack agent: новый принцип #11 (pre-install gate), шаг в Security Baseline, новый DoD пункт, поле `SOCKET.DEV PRE-INSTALL` в Handoff Envelope. (4) RU + EN локали зеркальны. (5) 12 sidecar файлов синхронизированы (RU + EN × 6 файлов). (6) Bonus: фиксы из v2.0.2 (sidecar metadata + regression test + prepack:doctor:all) включены в этот же релиз. P0 алерты от socket.dev блокируют установку до явного подтверждения. Degraded mode (socket-mcp недоступен) — review не блокируется, но статус фиксируется. | package.json v2.1.0, domains/development/.agents/skills/dependency-supply-chain-review/**, domains/development/agents/{reviewer,senior_full_stack}.md, domains/content/** (sidecar fixes из v2.0.2), src/__tests__/metadataAudit.test.ts |
-| Bugfix v2.4.1 | 2026-04-29 | **Domain karpathy fix + Gemini agent rename**. Bugfix-pipeline (CONDUCTOR → DEV → REV → TEST → RG) с user sign-off на каждом гейте. **Часть A — karpathy в доменах:** v2.4.0 поставил `$karpathy-guidelines` в легаси-корень репо, но забыл скопировать папку скила в `domains/<id>/.agents/skills/`, при этом 32 файла агентов в доменах уже ссылались на скил. При установке через `--domain <id>` скил физически отсутствовал. Скил скопирован в 4 домена × 2 локали (56 файлов), секция «Cross-cutting / Quality» добавлена в 8 файлов AGENTS.md. **Часть B — Gemini agent rename:** до v2.4.1 Gemini-адаптер ставил агентов как `<agentsDir>/<agentName>/prompt.md`, теперь как `<agentsDir>/<agentName>/<agentName>.md`. Добавлена `migrateLegacyGeminiPromptFiles` миграция в `runInstall`: переименовывает legacy `prompt.md` → `<agentName>.md` (сохраняя user-customized content под skip mode), патчит `promptFile` поле в legacy `config.json`, чистит orphan файлы. Идемпотентна, под backup/rollback covered. **Часть C — регрессионный тест:** новый `agentSkillResolution.test.ts` проверяет резолвимость каждого `$skill-name` из агентов в существующую папку скила домена. Тест нашёл 2 пре-существующих бага: (1) литеральный `$skill-name` плейсхолдер в `analytics/data_analyst.md` (RU+EN) — заменён на `` `<skill-name>` ``; (2) `$google-stitch` → `$google-stitch-skill` в `development/ux_ui_designer.md` (RU+EN). **Verification:** 102/102 тестов PASS, doctor:all PASS на всех 4 доменах × 5 targets, end-to-end smoke-install gemini target в tmp подтвердил миграцию с user customizations preserved. | package.json v2.4.1, domains/{development,content,analytics,product}/.agents/skills/karpathy-guidelines/**, domains/{...}/locales/en/.agents/skills/karpathy-guidelines/**, domains/{...}/AGENTS.md (RU+EN), src/installer.ts, src/platforms/adapters.ts, src/__tests__/agentSkillResolution.test.ts (NEW), src/__tests__/installer.test.ts, src/__tests__/domainIntegration.test.ts |