code-ai-installer 1.3.1 → 1.4.0

package/.agents/current_state_analysis/SKILL.md

@@ -1,225 +0,0 @@
----
-name: current_state_analysis
-description: Анализ текущей архитектуры репозитория — конвенции, паттерны, техдолг, узкие места масштабирования, риски безопасности и консистентность.
----
-
-# Skill: Current State Analysis
-
-Системный аудит существующего кода перед началом новой задачи.
-
-**Разделы:**
-1. [Когда использовать](#1-когда-использовать)
-2. [Алгоритм аудита](#2-алгоритм)
-3. [Что искать (checklist)](#3-что-искать)
-4. [Severity levels](#4-severity)
-5. [Output Template](#5-output-template)
-6. [Пример анализа](#6-пример)
-
----
-
-## 1. Когда использовать
-
-- Проект уже существует / есть репозиторий с кодом
-- Перед ARCH gate (новая фича, рефакторинг, миграция)
-- Есть legacy или частично реализованные фичи
-- Команда хочет понять текущее состояние перед планированием
-
----
-
-## 2. Алгоритм
-
-```
-1. Обзор структуры (5 min)
-   ├── list_dir → root, src/, packages/
-   ├── package.json → deps, scripts, engines
-   ├── Docker files → сервисы, порты, volumes
-   └── Config files → .env.example, tsconfig, biome, vitest
-
-2. Идентификация паттернов (10 min)
-   ├── FE: framework, state management, routing, styling
-   ├── BE: framework, layers (router/controller/service/repo), middleware
-   ├── Data: ORM/ODM, schema strategy, migrations
-   └── Infra: CI/CD, Docker, reverse proxy, certs
-
-3. Поиск узких мест (10 min)
-   ├── grep_search → console.log, TODO, FIXME, HACK, XXX
-   ├── grep_search → hardcoded secrets, passwords, API keys
-   ├── grep_search → any, eslint-disable, @ts-ignore
-   ├── find_by_name → *.test.*, *.spec.* (coverage)
-   └── Ручная проверка → N+1, god objects, tight coupling
-
-4. Фиксация findings (5 min)
-   └── Заполнить Output Template (section 5)
-
-5. Формирование рекомендаций
-   └── Quick wins (< 1h) vs Strategic (> 1 sprint)
-```
-
----
-
-## 3. Что искать
-
-### Структура и конвенции
-
-| Что проверить | Как | Red flag |
-|--------------|-----|----------|
-| Слои (FE/BE) | `list_dir` src/ | Нет чёткого разделения |
-| Naming | Файлы, переменные, exports | Смешанные стили (camelCase + snake_case) |
-| JSDoc | `grep_search` `@param` | Нет документации функций |
-| Imports | Абсолютные vs относительные | `../../../` — deep nesting |
-| Config | `.env.example`, schema validation | Нет валидации env vars |
-
-### Технический долг
-
-| Что искать | Grep pattern | Severity |
-|-----------|-------------|----------|
-| `console.log` в production | `console.log` (исключая тесты) | P1 |
-| TODO/FIXME | `TODO\|FIXME\|HACK\|XXX` | P1-P2 |
-| Hardcoded secrets | `password.*=\|secret.*=\|apiKey.*=` | 🔴 P0 |
-| Disabled linting | `eslint-disable\|@ts-ignore\|biome-ignore` | P1 |
-| `any` types | `:\s*any\b` (в .ts файлах) | P1 |
-| Missing error handling | `catch\s*\(\s*\)` (empty catch) | P1 |
-| Outdated deps | `npm outdated` / `npm audit` | P1-P2 |
-| Dead code | Unused exports, unreachable branches | P2 |
-
-### Производительность
-
-| Что искать | Где | Red flag |
-|-----------|-----|----------|
-| N+1 queries | Loops с DB calls внутри | 🔴 P0 |
-| Missing indexes | Schema definitions | P0-P1 |
-| No `.lean()` | Mongoose queries в API responses | P1 |
-| No `.select()` | Full document fetch для list endpoints | P1 |
-| `skip()` pagination | Large collections | P1 |
-| Sync heavy ops | Main thread blocking | P0 |
-
-### Безопасность
-
-| Что искать | Как | Severity |
-|-----------|-----|----------|
-| NoSQL injection | `Model.find(req.query)` | 🔴 P0 |
-| XSS | `dangerouslySetInnerHTML` без sanitize | 🔴 P0 |
-| Secrets в коде | `grep_search` API keys, tokens | 🔴 P0 |
-| No Helmet | Express без `helmet()` | P1 |
-| No CORS whitelist | `cors({ origin: '*' })` | P1 |
-| No rate limiting | Public endpoints без throttle | P1 |
-
----
-
-## 4. Severity
-
-| Level | Описание | Действие |
-|-------|---------|----------|
-| 🔴 **P0** | Блокер: security vulnerability, data loss risk, broken core flow | Исправить до release |
-| 🟠 **P1** | Важно: tech debt, missing validation, no tests, performance risk | Запланировать в текущем спринте |
-| 🟡 **P2** | Улучшение: code style, naming, dead code, minor optimizations | Backlog |
-
----
-
-## 5. Output Template
-
-```markdown
-# Current State Analysis: <project-name>
-
-**Date:** YYYY-MM-DD
-**Analyst:** Architect Agent
-**Scope:** <что анализировали>
-
-## Summary
-<1-2 абзаца: что это за проект, ключевые технологии, текущий статус>
-
-## Stack
-| Layer | Technology | Version |
-|-------|-----------|---------|
-| Frontend | React | 18.x |
-| Backend | Express | 4.x |
-| Database | MongoDB + Mongoose | 7.x |
-| Infra | Docker + Caddy | ... |
-
-## Conventions (обнаруженные паттерны)
-- **Naming:** camelCase для файлов, PascalCase для компонентов
-- **Layers:** router → controller → service → repository
-- **State:** Zustand / context
-- **Styling:** CSS Modules / Tailwind
-- **Testing:** Vitest + RTL
-
-## Technical Debt
-
-| # | Finding | Severity | Location | Recommendation |
-|---|---------|----------|----------|----------------|
-| 1 | No input validation on API endpoints | 🔴 P0 | `api/routes/*.js` | Add Zod schemas |
-| 2 | console.log in production code | 🟠 P1 | 12 files | Replace with pino logger |
-| 3 | No JSDoc on service functions | 🟡 P2 | `api/services/` | Add JSDoc blocks |
-
-## Scalability Limits
-- <конкретные bottlenecks: no indexes, sync ops, no cache, etc.>
-
-## Security Notes
-- <hardcoded secrets, no CORS, injection risks, etc.>
-
-## Recommendations
-
-### Quick Wins (< 1 hour each)
-1. Add Helmet middleware
-2. Add .env validation (Zod)
-3. Replace console.log with pino
-
-### Strategic (requires planning)
-1. ARCH-xx: Implement input validation layer
-2. ARCH-xx: Add integration tests for critical paths
-3. ARCH-xx: Set up CI pipeline
-
-## Next Actions
-- [ ] ARCH-01: <описание>
-- [ ] ARCH-02: <описание>
-```
-
----
-
-## 6. Пример анализа (фрагмент)
-
-```markdown
-# Current State Analysis: Smart Cart Rescue
-
-**Date:** 2025-12-01
-**Scope:** Full repository audit
-
-## Summary
-Wix Self-Hosted App с Dashboard (React 18 + Vite) и API (Express 4).
-Embedded Script показывает popup на Wix сайтах.
-Монорепо с Docker Compose + Caddy gateway.
-
-## Technical Debt
-
-| # | Finding | Severity | Location | Recommendation |
-|---|---------|----------|----------|----------------|
-| 1 | Widget payload hardcoded in script | 🔴 P0 | `widget/embedded-script.js` | Fetch from API |
-| 2 | No error boundaries in React | 🟠 P1 | Dashboard components | Add ErrorBoundary wrapper |
-| 3 | Mixed import styles (CJS + ESM) | 🟡 P2 | API server files | Migrate to ESM |
-
-## Scalability Limits
-- No DB indexes on `settings.appInstanceId` (collection scan on every widget request)
-- Embedded script fetches config on every page load (no caching)
-
-## Quick Wins
-1. Add compound index `{ appInstanceId: 1 }` on settings collection
-2. Add `Cache-Control` header to widget endpoint
-3. Add Helmet to Express app
-```
-
----
-
-## Deliverables
-
-| Артефакт | Формат | Где сохранять |
-|---------|--------|---------------|
-| Current State Analysis | Markdown (output template above) | `docs/architecture/current-state-analysis.md` |
-| Tech Debt backlog | ARCH-xx items | `docs/architecture/tech-debt.md` или задачи в backlog |
-
----
-
-## См. также
-- `$system_design_checklist` — checklist для нового дизайна
-- `$architecture_doc` — полный Architecture Document
-- `$security_baseline_dev` — детальная проверка безопасности
-- `$observability_logging` — наблюдаемость

package/.agents/data_model/SKILL.md

@@ -1,285 +0,0 @@
----
-name: data_model
-description: Модель данных и стратегия хранения — нормализация/денормализация, индексы, транзакции, кэш, (опц.) event sourcing/eventual consistency — с trade-offs и привязкой к UX flows.
----
-
-# Skill: Data Model
-
-Модель данных: от entity definitions до query optimization.
-
-**Разделы:**
-1. [Входы](#1-входы)
-2. [Entity Definition Template](#2-entity-template)
-3. [ER Diagram](#3-er-diagram)
-4. [Data Patterns](#4-data-patterns)
-5. [Index Strategy](#5-indexes)
-6. [Query Pattern Mapping](#6-query-mapping)
-7. [Transactions](#7-transactions)
-8. [Migrations](#8-migrations)
-9. [Пример: полная модель](#9-пример)
-10. [Output Template](#10-output)
-
----
-
-## 1. Входы
-
-| Вход | Откуда | Зачем |
-|------|--------|-------|
-| PRD | PM gate | Acceptance criteria → entities, constraints |
-| UX Spec | UX gate | Screens/flows → query patterns |
-| API Contracts | Architect | Request/Response → fields, types |
-| NFR | System Design | Volume, latency, retention |
-
----
-
-## 2. Entity Definition Template
-
-Для каждой сущности:
-
-```markdown
-### Entity: Coupon
-
-**Collection:** `coupons`
-**Lifecycle:** Created by site owner, read by embedded script, deleted manually
-
-| Field | Type | Required | Default | Constraints | Description |
-|-------|------|----------|---------|-------------|-------------|
-| _id | ObjectId | auto | auto | unique | Primary key |
-| appInstanceId | string | ✅ | — | indexed | Installation reference |
-| code | string | ✅ | — | 3-20 chars, uppercase, alphanumeric | Coupon code |
-| discount | number | ✅ | — | 1-100 | Discount value |
-| type | string | ✅ | "percent" | enum: percent, fixed | Discount type |
-| active | boolean | ⬜ | true | — | Is coupon active |
-| usageCount | number | ⬜ | 0 | min: 0 | Times used |
-| createdAt | Date | auto | now | — | Timestamp |
-| updatedAt | Date | auto | now | — | Timestamp |
-
-**Unique constraints:** (appInstanceId, code)
-**Indexes:** See Index Strategy
-**Relationships:** belongs to Installation (via appInstanceId)
-**Storage pattern:** Reference (separate collection)
-**Rationale:** Coupons have independent lifecycle, unbounded per installation
-```
-
----
-
-## 3. ER Diagram
-
-```mermaid
-erDiagram
-    INSTALLATION ||--|| SETTINGS : "has one"
-    INSTALLATION ||--o{ COUPON : "has many"
-
-    INSTALLATION {
-        ObjectId _id PK
-        string appInstanceId UK
-        string instanceId
-        string siteUrl
-        string status
-        Date installedAt
-    }
-
-    SETTINGS {
-        ObjectId _id PK
-        string appInstanceId UK "FK → Installation"
-        object overlay
-        object cta
-        object tab
-        object timer
-        string designStyle
-        string templateId
-        object templateSettings
-    }
-
-    COUPON {
-        ObjectId _id PK
-        string appInstanceId "FK → Installation"
-        string code
-        number discount
-        string type
-        boolean active
-        number usageCount
-        Date createdAt
-    }
-```
-
----
-
-## 4. Data Patterns
-
-### Embed vs Reference Decision
-
-| Критерий | Embed ✅ | Reference ✅ |
-|---------|---------|-------------|
-| Читаются вместе | Да | Нет |
-| Independent lifecycle | Нет | Да |
-| Bounded size | Да (< 50 items) | Unbounded |
-| Atomic updates child | Нужны | Не критично |
-
-### Decision table (для проекта)
-
-| Parent | Child | Pattern | Rationale |
-|--------|-------|---------|-----------|
-| Installation | Settings | **Embed** (или 1:1 ref) | Всегда читаются вместе, 1 settings per install |
-| Installation | Coupons | **Reference** | Independent CRUD, unbounded, own pagination |
-| Settings | overlay/cta/tab | **Embed** | Bounded subdocuments, always read together |
-
-> Каждый выбор embed/reference = потенциальный ADR. Если неочевидно — создай `$adr_log`.
-
-### Caching (если применимо)
-
-| Data | Cache? | Strategy | TTL | Invalidation |
-|------|--------|----------|-----|-------------|
-| Widget config | ✅ | HTTP Cache-Control | 60s | PUT settings → purge |
-| Coupon list | ⬜ | No cache (small, dashboard only) | — | — |
-| Settings (dashboard) | ⬜ | No cache (always fresh) | — | — |
-
----
-
-## 5. Index Strategy
-
-### Index → Query Pattern Mapping
-
-| Index | Fields | Type | Serves Query |
-|-------|--------|------|-------------|
-| `installations_appInstanceId` | `{ appInstanceId: 1 }` | unique | Lookup by appInstanceId |
-| `settings_appInstanceId` | `{ appInstanceId: 1 }` | unique | Lookup settings by install |
-| `coupons_app_code` | `{ appInstanceId: 1, code: 1 }` | unique | Duplicate check on create |
-| `coupons_app_active_date` | `{ appInstanceId: 1, active: 1, createdAt: -1 }` | compound | List active coupons sorted by date |
-| `coupons_app_date` | `{ appInstanceId: 1, createdAt: -1 }` | compound | List all coupons sorted |
-
-### Index rules
-
-| Правило | Описание |
-|---------|---------|
-| **ESR** | Equality → Sort → Range (порядок полей в compound) |
-| **Max 5-7** | Каждый index = write overhead |
-| **Verify** | `explain('executionStats')` → IXSCAN, не COLLSCAN |
-| **Partial** | Если index нужен не для всех docs: `partialFilterExpression` |
-
----
-
-## 6. Query Pattern Mapping
-
-Маппинг UX screen → query:
-
-| UX Screen | Action | Query | Index Used |
-|-----------|--------|-------|------------|
-| Dashboard: Coupons list | Load page | `find({ appInstanceId }).sort({ createdAt: -1 }).limit(20)` | `coupons_app_date` |
-| Dashboard: Coupons list | Filter active | `find({ appInstanceId, active: true }).sort({ createdAt: -1 })` | `coupons_app_active_date` |
-| Dashboard: Coupons list | Search by code | `find({ appInstanceId, code: { $regex } })` | `coupons_app_code` (prefix) |
-| Dashboard: Settings | Load | `findOne({ appInstanceId })` | `settings_appInstanceId` |
-| Dashboard: Settings | Save | `updateOne({ appInstanceId }, { $set: ... })` | `settings_appInstanceId` |
-| Embedded Script | Load config | `findOne({ appInstanceId })` + `findOne({ appInstanceId, active: true }).sort({ createdAt: -1 })` | `settings_appInstanceId` + `coupons_app_active_date` |
-| Webhook: install | Create | `updateOne({ appInstanceId }, { ... }, { upsert: true })` | `installations_appInstanceId` |
-
-### Performance notes
-
-| Query | Expected latency | Volume | Notes |
-|-------|-----------------|--------|-------|
-| Widget config | < 10ms | Every page view | Add cache header |
-| Coupons list | < 20ms | Dashboard only | Paginated |
-| Settings load | < 5ms | Dashboard only | Single doc |
-
----
-
-## 7. Transactions
-
-### Когда нужны
-
-| Scenario | Transaction? | Rationale |
-|----------|:---:|-----------|
-| Create coupon | ⬜ No | Single collection write |
-| Update settings | ⬜ No | Single document update |
-| Apply coupon (if order system) | ✅ Yes | Multi-doc: update order + increment usage |
-| Install webhook (upsert install + settings) | ⬜ No | Idempotent upserts, eventual consistency OK |
-
-### Правило
-
-> MongoDB любит моделирование, где транзакции нужны **редко**. Если транзакция нужна часто — пересмотри schema (может стоит embed).
-
----
-
-## 8. Migrations
-
-### Strategy
-
-| Когда | Как |
-|-------|-----|
-| Новое поле (optional) | Добавить в schema + `$setOnInsert` default |
-| Новое поле (required) | Migration script: `updateMany` + backfill |
-| Rename field | Migration script + update code + period with both fields |
-| Remove field | Migration script: `$unset` + remove from schema |
-| Change type | Два шага: add new field → migrate data → remove old |
-
-### Tool
-
-```bash
-npx migrate-mongo create add-templateId-to-settings
-npx migrate-mongo up
-npx migrate-mongo down   # rollback
-npx migrate-mongo status
-```
-
----
-
-## 9. Пример: полная модель
-
-```markdown
-# Data Model: Smart Cart Rescue
-
-## Entities
-1. Installation — Wix app installation record
-2. Settings — Widget configuration (1:1 with Installation)
-3. Coupon — Discount coupons (1:N with Installation)
-
-## Storage
-- MongoDB 7 (single instance, Docker)
-- Mongoose ODM (strict: 'throw')
-- Timestamps on all collections
-
-## Key decisions
-- Settings embedded approach considered, but separate collection for independent API
-- Coupons always referenced (unbounded, independent CRUD)
-- See ADR-001 (MongoDB), ADR-003 (embed vs reference)
-```
-
----
-
-## 10. Output Template
-
-```markdown
-# Data Model: <project-name>
-
-**Date:** YYYY-MM-DD
-**Database:** MongoDB 7 + Mongoose
-
-## ER Diagram
-<mermaid diagram>
-
-## Entities
-<for each entity: section 2 template>
-
-## Data Patterns
-<embed vs ref decisions with rationale>
-
-## Indexes
-<section 5 table>
-
-## Query Mapping
-<section 6 table>
-
-## Transactions
-<section 7 table>
-
-## Migration Strategy
-<section 8>
-```
-
----
-
-## См. также
-- `$api_contracts` — API endpoints (schemas match entity fields)
-- `$mongodb_mongoose_best_practices` — implementation patterns
-- `$architecture_doc` — Architecture Document (data model section)
-- `$adr_log` — ADR for embed/reference/DB decisions