code-ai-installer 2.0.1 → 2.2.0

package/.agents/skills/dependency-supply-chain-review/SKILL.md

@@ -1,13 +1,18 @@
 ---
 name: dependency-supply-chain-review
-description: Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов.
+description: Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку.
+last_verified: 2026-04-08
+version: 2.0
+mcp_server: socket-mcp
 ---
 
 # Skill: Dependency & Supply Chain Review
 
-Аудит npm-зависимостей: уязвимости, лицензии, подозрительные пакеты.
+Аудит npm-зависимостей: supply chain, уязвимости, лицензии, подозрительные пакеты.
+**С версии 2.0** — обязательная интеграция с **socket.dev MCP** (`depscore`) для каждого нового или обновляемого пакета. P0-алерты блокируют установку до явного подтверждения пользователя.
 
 **Разделы:**
+0. [Prerequisites — Socket.dev MCP](#0-prerequisites)
 1. [Когда активировать](#1-когда)
 2. [Audit Commands](#2-audit)
 3. [Checklist](#3-checklist)
@@ -16,6 +21,70 @@ description: Ревью зависимостей — минимизация, о
 6. [Decision Framework](#6-decision)
 7. [CI Integration](#7-ci)
 8. [Output Template](#8-output)
+9. [Socket.dev Integration](#9-socket-dev)
+
+---
+
+## 0. Prerequisites — Socket.dev MCP <a id="0-prerequisites"></a>
+
+> [!IMPORTANT]
+> **Socket.dev MCP — обязательное требование с v2.0.** Без него этот skill работает в **degraded mode** с пометкой в отчёте.
+
+### Зачем
+
+[socket.dev](https://socket.dev) даёт автоматизированную supply-chain аналитику пакетов: обнаружение malware, typosquatting, подозрительных maintainer-смен, native binding рисков. Без него ревью полагается только на `npm audit`, который ловит лишь известные CVE.
+
+### Установка (рекомендуемый способ — HTTP, без API-ключа)
+
+Добавь в `mcpServers` конфиг своего AI-клиента (Claude Code / Codex / Qwen / Copilot / Antigravity):
+
+```json
+{
+  "mcpServers": {
+    "socket-mcp": {
+      "type": "http",
+      "url": "https://mcp.socket.dev/"
+    }
+  }
+}
+```
+
+### Альтернатива — stdio с API-ключом (для команд с paid socket.dev аккаунтом)
+
+```json
+{
+  "mcpServers": {
+    "socket-mcp": {
+      "command": "npx",
+      "args": ["-y", "@socketsecurity/mcp@latest"],
+      "env": {
+        "SOCKET_API_KEY": "your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+API-ключ можно получить на https://socket.dev/.
+
+### Detection protocol (агент выполняет перед началом ревью)
+
+1. Попробовать вызвать `depscore` для тестового пакета (например, `lodash@4.17.21`).
+2. Если tool доступен и вернул валидный ответ → **Active mode**, продолжаем.
+3. Если tool недоступен → **degraded mode**, выполнить шаги ниже.
+
+### Degraded mode protocol
+
+Если `socket-mcp` не подключён:
+
+1. **Залогировать предупреждение**: `[degraded] socket-mcp not detected — falling back to npm audit only`.
+2. **Предложить установку**: показать пользователю оба JSON-снипета (HTTP + stdio) и спросить:
+   > "Socket.dev MCP не подключён. Хочешь установить сейчас? (HTTP-mode не требует API-ключа). [y/n]"
+3. Если **y** → дать инструкцию: «Добавь сниппет в `mcpServers` конфиг своего AI-клиента и перезапусти сессию», после рестарта повторить detection.
+4. Если **n** или после установки tool всё ещё недоступен → продолжать review с пометкой `Mode: Degraded` в Output Template, fallback на `npm audit` + manual checks из раздела 4 (Red Flags).
+
+> [!WARNING]
+> В degraded mode review **не блокирует** мерж по DEP-05a/05b/05c (socket-checks), но Reviewer обязан явно зафиксировать degraded-статус в Handoff Envelope.
 
 ---
 
@@ -95,11 +164,18 @@ grep_search: Query="prebuild" SearchPath="package-lock.json"
 | # | Check | Severity | Status |
 |---|-------|----------|--------|
 | DEP-05 | `npm audit` — no high/critical vulnerabilities | 🔴 P0 | ☐ |
+| DEP-05a | socket.dev `depscore.supply_chain ≥ 0.75` для всех новых/обновлённых deps | 🔴 P0 | ☐ |
+| DEP-05b | socket.dev `depscore.vulnerability ≥ 0.80` | 🔴 P0 | ☐ |
+| DEP-05c | socket.dev `depscore.license ≥ 0.50` (нет копилефт-контаминации) | 🔴 P0 | ☐ |
+| DEP-05d | socket-mcp tool detected (не degraded mode) | 🟠 P1 | ☐ |
 | DEP-06 | `package-lock.json` committed and up to date | 🔴 P0 | ☐ |
 | DEP-07 | No `npm install` with `--force` or `--legacy-peer-deps` (unless justified) | 🟠 P1 | ☐ |
 | DEP-08 | No postinstall scripts from untrusted packages | 🔴 P0 | ☐ |
 | DEP-09 | Packages use well-known publishers (npm org verified) | 🟠 P1 | ☐ |
 
+> [!NOTE]
+> DEP-05a/05b/05c проверяются автоматически через socket.dev `depscore` (см. раздел [9. Socket.dev Integration](#9-socket-dev)). В **degraded mode** эти чеки помечаются `N/A — degraded` и не блокируют merge, но Reviewer обязан зафиксировать это в Output Template.
+
 ### 3.3 Maintenance
 
 | # | Check | Severity | Status |
@@ -262,10 +338,22 @@ dependency-review:
 **Reviewer:** Reviewer Agent
 **Total deps:** production: XX, dev: YY
 
+## Socket.dev Audit
+- **Mode:** ✅ Active / ⚠️ **Degraded** (socket-mcp not available)
+- Packages scanned: XX
+- P0 blockers: Y
+- P1 warnings: Z
+
+| Package | supply_chain | vuln | license | quality | maint | Verdict |
+|---------|--------------|------|---------|---------|-------|---------|
+| `zod@3.22.0` | 0.95 | 0.92 | 1.00 | 0.88 | 0.91 | ✅ OK |
+| `event-stream@3.3.6` | 0.10 | 0.05 | 0.85 | 0.40 | 0.20 | 🔴 P0 BLOCK |
+
 ## Audit Results
 | Check | Result |
 |-------|--------|
 | npm audit | ✅ No high/critical |
+| socket.dev depscore | ✅ All deps pass / 🔴 1 P0 blocker / ⚠️ Degraded |
 | License check | ⚠️ 1 GPL package found |
 | Unused deps | ✅ All used |
 | Outdated (major) | ⚠️ 3 packages behind |
@@ -274,7 +362,7 @@ dependency-review:
 
 | # | Severity | Package | Finding | Action |
 |---|----------|---------|---------|--------|
-| 1 | 🔴 P0 | `event-stream@3.3.6` | Known supply chain attack | Remove immediately |
+| 1 | 🔴 P0 | `event-stream@3.3.6` | socket.dev: supply_chain=0.10 (known attack) | Remove immediately |
 | 2 | 🟠 P1 | `moment@2.29.1` | 290KB, abandoned | Replace with dayjs |
 | 3 | 🟠 P1 | `some-lib@0.1.0` | GPL-3.0 license | Replace or get legal approval |
 | 4 | 🟡 P2 | `lodash@4.17.21` | Only using `debounce` | Replace with `lodash.debounce` or native |
@@ -293,8 +381,97 @@ dependency-review:
 
 ---
 
+## 9. Socket.dev Integration <a id="9-socket-dev"></a>
+
+### Tool: `depscore`
+
+`@socketsecurity/mcp` экспонирует **один** tool — `depscore`, который возвращает пять метрик по каждому пакету:
+
+| Метрика | Что значит |
+|---------|------------|
+| `supply_chain` | Риск supply-chain атак (typosquatting, malware, маинтейнер-смены, скрипты) |
+| `vulnerability` | Известные CVE и уязвимости |
+| `quality` | Качество кода, тесты, documentation |
+| `maintenance` | Активность мейнтенера, частота релизов |
+| `license` | Соответствие лицензии (низкий = копилефт / unlicensed) |
+
+Все метрики в диапазоне `0.0–1.0`, где `1.0` = идеально.
+
+### Tool call
+
+```javascript
+depscore({
+  packages: [
+    { ecosystem: "npm", depname: "lodash", version: "4.17.21" },
+    { ecosystem: "npm", depname: "zod", version: "3.22.0" }
+  ]
+})
+```
+
+Возвращает строки в формате:
+```
+pkg:npm/lodash@4.17.21: supply_chain: 0.95, quality: 0.88, maintenance: 0.91, vulnerability: 0.92, license: 1.0
+pkg:npm/zod@3.22.0: supply_chain: 0.97, quality: 0.95, maintenance: 0.93, vulnerability: 0.95, license: 1.0
+```
+
+### Threshold matrix (action policy)
+
+| Метрика | Range | Severity | Action |
+|---------|-------|----------|--------|
+| `supply_chain` | < 0.50 | 🔴 **P0** | **BLOCK** — эскалировать пользователю с metrics |
+| `supply_chain` | 0.50 – 0.74 | 🟠 P1 | WARN — требовать обоснование |
+| `supply_chain` | ≥ 0.75 | ✅ | OK |
+| `vulnerability` | < 0.50 | 🔴 **P0** | **BLOCK** |
+| `vulnerability` | 0.50 – 0.79 | 🟠 P1 | WARN |
+| `vulnerability` | ≥ 0.80 | ✅ | OK |
+| `license` | < 0.50 | 🔴 **P0** | **BLOCK** — вероятно копилефт/unlicensed |
+| `license` | ≥ 0.50 | ✅ | OK |
+| `quality` | < 0.50 | 🟡 P2 | INFO |
+| `maintenance` | < 0.50 | 🟡 P2 | INFO (заброшен) |
+
+### Workflow для агента (псевдокод)
+
+```
+для каждого нового или обновлённого пакета (из package.json diff):
+  result = depscore({ packages: [{ ecosystem: "npm", depname, version }] })
+  metrics = parse(result)
+
+  if metrics.supply_chain < 0.50
+     OR metrics.vulnerability < 0.50
+     OR metrics.license < 0.50:
+    → 🔴 P0 BLOCK
+    → эскалировать пользователю: "Пакет X имеет критический алерт socket.dev: <metric>=<value>. Установка заблокирована. Подтверди явно если хочешь продолжить."
+    → ждать подтверждения
+
+  elif any метрика в P1 диапазоне:
+    → 🟠 P1 WARN
+    → добавить в Findings с пометкой "требует обоснования"
+
+  else:
+    → ✅ OK
+    → продолжать
+
+записать все результаты в Output Template → Socket.dev Audit table
+```
+
+### Когда вызывать `depscore`
+
+| Триггер | Кто вызывает |
+|---------|--------------|
+| DEV: перед `npm install <pkg>` | Senior Full Stack |
+| DEV: перед `npm update` или bump major-версии | Senior Full Stack |
+| REV: при ревью PR с изменениями `package.json` / `package-lock.json` | Reviewer |
+| RG: pre-release полный аудит всех production deps | Reviewer (по запросу Conductor) |
+
+### Batch optimization
+
+Для больших diff (>10 пакетов) — батчить вызовы по 10–20 пакетов в одном `depscore({ packages: [...] })`. Socket.dev принимает массив, не нужно дёргать по одному.
+
+---
+
 ## См. также
 - `$security-review` — application security review
 - `$security-baseline-dev` — secure coding patterns
 - `$cloud-infrastructure-security` — CI/CD pipeline security
-- `$tooling-bun-biome` — package manager setup
+- `$tooling-bun-biome` — package manager setup
+- [socket.dev MCP server](https://github.com/SocketDev/socket-mcp) — официальный репо

package/.agents/skills/dependency-supply-chain-review/agents/claude.json

@@ -1,13 +1,13 @@
 {
   "name": "dependency-supply-chain-review",
   "display_name": "Проверка зависимостей и цепочки поставок",
-  "description": "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов.",
+  "description": "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку.",
   "default_prompt": "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\".",
   "triggers": [
     "dependency-supply-chain-review",
     "dependency supply chain review",
     "Проверка зависимостей и цепочки поставок",
-    "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов"
+    "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку"
   ],
   "capabilities": [
     "dependency",

package/.agents/skills/dependency-supply-chain-review/agents/copilot.json

@@ -1,13 +1,13 @@
 {
   "name": "dependency-supply-chain-review",
   "display_name": "Проверка зависимостей и цепочки поставок",
-  "description": "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов.",
+  "description": "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку.",
   "default_prompt": "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\".",
   "triggers": [
     "dependency-supply-chain-review",
     "dependency supply chain review",
     "Проверка зависимостей и цепочки поставок",
-    "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов"
+    "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку"
   ],
   "capabilities": [
     "dependency",

package/.agents/skills/dependency-supply-chain-review/agents/gemini.json

@@ -1,13 +1,13 @@
 {
   "name": "dependency-supply-chain-review",
   "display_name": "Проверка зависимостей и цепочки поставок",
-  "description": "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов.",
+  "description": "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку.",
   "default_prompt": "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\".",
   "triggers": [
     "dependency-supply-chain-review",
     "dependency supply chain review",
     "Проверка зависимостей и цепочки поставок",
-    "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов"
+    "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку"
   ],
   "capabilities": [
     "dependency",

package/.agents/skills/dependency-supply-chain-review/agents/openai.yaml

@@ -1,6 +1,6 @@
 interface:
   display_name: "Проверка зависимостей и цепочки поставок"
-  short_description: "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных…"
+  short_description: "Ревью зависимостей с socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 блок."
   default_prompt: "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\"."
 dependencies:
   tools: []

package/.agents/skills/dependency-supply-chain-review/agents/qwen.json

@@ -1,13 +1,13 @@
 {
   "name": "dependency-supply-chain-review",
   "display_name": "Проверка зависимостей и цепочки поставок",
-  "description": "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов.",
+  "description": "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку.",
   "default_prompt": "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\".",
   "triggers": [
     "dependency-supply-chain-review",
     "dependency supply chain review",
     "Проверка зависимостей и цепочки поставок",
-    "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов"
+    "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку"
   ],
   "capabilities": [
     "dependency",

package/.agents/skills/dependency-supply-chain-review/agents/skill.yaml

@@ -1,13 +1,13 @@
 version: 1
 name: "dependency-supply-chain-review"
 display_name: "Проверка зависимостей и цепочки поставок"
-description: "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов."
+description: "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку."
 default_prompt: "Используй $dependency-supply-chain-review, когда задача относится к навыку \"Проверка зависимостей и цепочки поставок\"."
 triggers:
   - "dependency-supply-chain-review"
   - "dependency supply chain review"
   - "Проверка зависимостей и цепочки поставок"
-  - "Ревью зависимостей — минимизация, обновления, аудит уязвимостей, лицензии, запрет небезопасных пакетов"
+  - "Ревью зависимостей с обязательной проверкой через socket.dev MCP (depscore) — supply chain, vulnerability, лицензии. P0 алерты блокируют установку"
 capabilities:
   - "dependency"
   - "supply"

package/CONTEXT.md

@@ -4,9 +4,9 @@
 |------|----------|
 | **Название** | code-ai-installer |
 | **Описание** | CLI для установки AI-агентов и скилов для множества AI-ассистентов |
-| **Текущая фаза** | v2.0.0 — Domain System |
+| **Текущая фаза** | v2.1.0 — Socket.dev Supply-Chain Integration |
 | **Дата создания** | 2026-03-01 |
-| **Последнее обновление** | 2026-04-04 |
+| **Последнее обновление** | 2026-04-08 |
 
 ---
 
@@ -78,3 +78,5 @@
 | 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 |

package/agents/reviewer.md

@@ -21,6 +21,7 @@ Reviewer — это "quality gate" перед Tester и Release Gate.
 - API Contracts + Data Model + Threat Model baseline (если есть)
 - Deployment/CI Plan + Observability Plan (если релевантно)
 - PR diff / список файлов / ссылка на ветку / результаты CI
+- **socket-mcp tool availability** — обязательная проверка перед ревью изменений `package.json` / `package-lock.json`. Если недоступен → degraded mode (см. [`$dependency-supply-chain-review`](.agents/skills/dependency-supply-chain-review/) → раздел 0 Prerequisites).
 
 ---
 
@@ -30,6 +31,7 @@ Reviewer — это "quality gate" перед Tester и Release Gate.
 - Если нарушение влияет на безопасность/данные/архитектуру — это 🔴 P0.
 - Перед началом ревью **обязательно** прочитать секцию "Important vs Not Important" из Architecture Doc — не блокировать то, что архитектор намеренно вынес за скоуп.
 - Проверки git-гигиены (структура коммитов, нейминг веток/коммитов, косметика diff) классифицировать как 🟡 P2, если нет прямого влияния на безопасность/данные/архитектуру.
+- **Supply chain через socket.dev обязательны** для любого изменения `package.json` / `package-lock.json`. Запустить `$dependency-supply-chain-review` → `depscore` для всех новых/обновлённых пакетов. P0-алерты (`supply_chain<0.5` / `vulnerability<0.5` / `license<0.5`) = 🔴 NO-GO до явного подтверждения пользователя или удаления пакета. В **degraded mode** (socket-mcp недоступен) — review разрешён, но статус `Degraded` обязательно фиксируется в Handoff Envelope.
 
 ---
 
@@ -244,10 +246,11 @@ OPEN ITEMS: [список P1/P2 для трекинга]
 BLOCKERS FOR NEXT PHASE: [список P0, если есть]
 MERGE STATUS: GO ✅ / NO-GO ❌
 CONTAINER RELOAD VERIFIED: ✅ / ❌
+SOCKET.DEV MODE: Active ✅ / Degraded ⚠️ / N/A (no package.json changes)
 ```
 
 ## HANDOFF (Mandatory)
 - Every REV output must end with a completed `Handoff Envelope`.
-- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR NEXT PHASE`, `MERGE STATUS`, `CONTAINER RELOAD VERIFIED`.
+- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR NEXT PHASE`, `MERGE STATUS`, `CONTAINER RELOAD VERIFIED`, `SOCKET.DEV MODE`.
 - If `OPEN ITEMS` is not empty, include owner and due date per item.
 - Missing HANDOFF block means REV phase is `BLOCKED` and cannot move to QA/RG.

package/agents/senior_full_stack.md

@@ -50,6 +50,7 @@
 8. **Feedback loop** — после каждого среза обязательна DEMO-инструкция
 9. **Batch tasks** — задачи выполняются пакетами (10–15), образующими тестируемый вертикальный срез
 10. **Docker impact handoff** — после изменений кода DEV обязан передать DevOps список затронутых сервисов для обязательного перезапуска контейнеров
+11. **Socket.dev pre-install gate** — перед каждым `npm install <pkg>` / `npm update` / bump major-версии обязательно вызвать `depscore` через socket-mcp. P0-алерты (`supply_chain<0.5` / `vulnerability<0.5` / `license<0.5`) → **жёсткий блок**: остановиться, эскалировать пользователю, ждать явного подтверждения. В **degraded mode** (socket-mcp недоступен) — следовать degraded protocol из [`$dependency-supply-chain-review`](.agents/skills/dependency-supply-chain-review/) → раздел 0.
 
 ---
 
@@ -130,6 +131,12 @@
 - Единый безопасный формат ошибок (без stack trace)
 - Отсутствие секретов/PII в коде и логах
 - Гигиена зависимостей
+- **Socket.dev pre-install check** — перед каждым `npm install <pkg>`:
+  1. Вызвать `depscore({ packages: [{ ecosystem: "npm", depname, version }] })` через socket-mcp
+  2. Если `supply_chain < 0.5` ИЛИ `vulnerability < 0.5` ИЛИ `license < 0.5` → **STOP**, эскалировать пользователю с metrics, ждать явного подтверждения
+  3. Если все метрики OK → продолжить установку
+  4. Если socket-mcp недоступен → degraded protocol (см. `$dependency-supply-chain-review` раздел 0)
+  5. Зафиксировать metrics в DEV report для следующего гейта
 
 ### 6) Demo Gate
 После каждого `DEV-xx` предоставить `DEMO-xx`:
@@ -156,6 +163,7 @@
 - Секреты не в коде/логах
 - Есть DEMO-инструкция
 - Базовая безопасность: валидация входа, авторизация, гигиена зависимостей
+- **Socket.dev depscore выполнен для всех новых/обновлённых deps; нет P0-алертов (или явное подтверждение пользователя зафиксировано)**
 - Production-ready: нет mock-функций в рабочих сценариях
 - Anti-pattern self-check: PASS
 
@@ -276,10 +284,11 @@ ANTI-PATTERN CHECK: PASS ✅ / FAIL ❌
 JSDOC COVERAGE: X/Y
 CI STATUS: GREEN ✅ / RED ❌
 DEVOPS RELOAD REQUEST: affected services + suggested command (`restart` / `up -d --build`)
+SOCKET.DEV PRE-INSTALL: Active ✅ (N packages scanned, 0 P0) / Degraded ⚠️ / N/A (no new deps)
 ```
 
 ## HANDOFF (Mandatory)
 - Every DEV output must end with a completed `Handoff Envelope`.
-- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR REVIEW`, `ANTI-PATTERN CHECK`, `JSDOC COVERAGE`, `CI STATUS`.
+- Required fields: `HANDOFF TO`, `ARTIFACTS PRODUCED`, `REQUIRED INPUTS FULFILLED`, `OPEN ITEMS`, `BLOCKERS FOR REVIEW`, `ANTI-PATTERN CHECK`, `JSDOC COVERAGE`, `CI STATUS`, `SOCKET.DEV PRE-INSTALL`.
 - If `OPEN ITEMS` is not empty, include owner and due date per item.
 - Missing HANDOFF block means DEV phase is `BLOCKED` and cannot move to REV.

package/dist/domainResolver.js

@@ -3,12 +3,12 @@ import fs from "fs-extra";
 import { z } from "zod";
 /** Zod schema for domain.json manifest. */
 const domainManifestSchema = z.object({
-    id: z.enum(["development", "content"]),
+    id: z.enum(["development", "content", "analytics"]),
     name: z.string().min(1),
     description: z.string().min(1),
 });
 /** All valid domain identifiers for normalization. */
-const VALID_DOMAIN_IDS = ["development", "content"];
+const VALID_DOMAIN_IDS = ["development", "content", "analytics"];
 /**
  * Scans domains/ directory and returns available domain descriptors.
  * Returns empty array if domains/ doesn't exist or has no valid entries.

package/dist/index.js

@@ -86,7 +86,7 @@ program
     .command("list")
     .description("List available bundled agents and skills")
     .option("--project-dir <path>", "Optional custom source root path")
-    .option("--domain <name>", "Domain name (development | content)")
+    .option("--domain <name>", "Domain name (development | content | analytics)")
     .option("--lang <lang>", "Template language: ru | en", "ru")
     .action(async (options) => {
     try {
@@ -115,7 +115,7 @@ program
     .description("Check source and destination health before install")
     .requiredOption("--target <id>", "Target AI id")
     .option("--project-dir <path>", "Optional custom source root path")
-    .option("--domain <name>", "Domain name (development | content)")
+    .option("--domain <name>", "Domain name (development | content | analytics)")
     .option("--destination <path>", "Destination root (default: current directory)")
     .option("--lang <lang>", "Template language: ru | en", "ru")
     .action(async (options) => {
@@ -158,7 +158,7 @@ program
     .description("Install selected agents and skills for target AI")
     .requiredOption("--target <id>", "Target AI id")
     .option("--project-dir <path>", "Optional custom source root path")
-    .option("--domain <name>", "Domain name (development | content)")
+    .option("--domain <name>", "Domain name (development | content | analytics)")
     .option("--destination <path>", "Destination root (default: current directory)")
     .option("--create-dir <name>", "Create child folder in current directory and install there")
     .option("--lang <lang>", "Template language: ru | en", "ru")
@@ -229,7 +229,7 @@ program
     .command("uninstall")
     .description("Uninstall previously installed files for target")
     .requiredOption("--target <id>", "Target AI id")
-    .option("--domain <name>", "Domain name (development | content)")
+    .option("--domain <name>", "Domain name (development | content | analytics)")
     .option("--destination <path>", "Destination root", process.cwd())
     .option("--apply", "Execute delete operations (default is dry-run)", false)
     .action(async (options) => {

package/dist/types.d.ts

@@ -6,7 +6,7 @@ export type TemplateLanguage = "ru" | "en";
 /**
  * Supported domain identifiers.
  */
-export type DomainId = "development" | "content";
+export type DomainId = "development" | "content" | "analytics";
 /**
  * Domain metadata loaded from domain.json manifest + dynamic counts.
  */