# Perplexity Pack — План 1 (v8, floor-safe): перенос конфигурации

> **For agentic workers:** REQUIRED SUB-SKILL: superpowers:executing-plans (inline). Steps use checkbox syntax.

**Goal:** Аддитивно перенести три блока серверов research-слоя в main `.mcp.json` floor-safe способом, с байт-в-байт бэкапом через `cp -n` и защитой бэкапа в .gitignore.

**Architecture:** Вет (research-vet.md) и дом-README уже на диске (plan-v6). Этот план — только перенос. Файловые операции — харнес Write/Edit (пол не гейтит) + `cp -n` для бэкапа (байт-в-байт средствами ОС, не через LLM-память; идемпотентно — не затирает существующий бэкап; floor-safe — `cp` не arbitrary-exec и не destructive). Порядок: gitignore бэкапа → `cp -n` бэкап → Edit `.mcp.json`.

**Tech Stack:** харнес Write/Edit, `cp` (coreutils), JSON config `.mcp.json`.

## Цель

Доделать перенос конфигурации Perplexity Pack в main floor-safe способом. Реализует якорь
спеки {#D3} (перенос конфигурации) из
`docs/superpowers/specs/2026-06-14-perplexity-pack-research-tooling-design-v3.md`.

```skills-json
[]
```

```steps-json
[
  {"op":"Edit","object":".gitignore","ref":"D3"},
  {"op":"Bash","object":"cp -n .mcp.json .mcp.json.bak-perplexity-pack-20260614","ref":"D3"},
  {"op":"Edit","object":".mcp.json","ref":"D3"}
]
```

```verified-context-json
[
  {"id":"vc1","kind":"EXTRACTED","ref":".mcp.json","anchor":"\"$schema\": \"https://raw.githubusercontent.com/anthropics/claude-code/main/schemas/mcp.json\""},
  {"id":"vc2","kind":"EXTRACTED","ref":"docs/security/research-vet.md","anchor":"Провенанс-вет research-tooling"},
  {"id":"vc3","kind":"EXTRACTED","ref":"tools/cost-pricing.mjs","anchor":"export const PRICING = Object.freeze("}
]
```

---

## Task 3: Floor-safe перенос блоков в main `.mcp.json`

**Files:** Modify `.gitignore`, `.mcp.json`; Create `.mcp.json.bak-perplexity-pack-20260614` (через `cp -n`).

- [ ] **Step 1: Защитить бэкап в .gitignore** — Read `.gitignore` (авторизовано планом), затем Edit: добавить строку `.mcp.json.bak-*`, если её нет. Защита от случайного `git add` бэкапа.
- [ ] **Step 2: Байт-в-байт бэкап** — Run: `cp -n .mcp.json .mcp.json.bak-perplexity-pack-20260614` — Expected: бэкап создан побайтно средствами ОС (не через LLM-память → нет риска усечения). `-n` идемпотентен: повтор НЕ затирает существующий бэкап (точка отката = исходник сохраняется).
- [ ] **Step 3: Добавить три блока серверов** — Read `.mcp.json` (авторизовано), затем Edit: перед ключом `_disabled_marketing_servers_note` добавить три блока `mcpServers` по образцу `openapi`/`sentry`:
  - `perplexity` → `@perplexity-ai/mcp-server`, env `PERPLEXITY_API_KEY`, comment (research-канал; вет ПРИНЯТ; SLSA-provenance; MIT; ключ user env).
  - `exa` → `exa-mcp-server`, env `EXA_API_KEY`, comment (нейро-поиск; ПРИНЯТ; MIT; license-поле npm пусто — research-vet).
  - `firecrawl` → `firecrawl-mcp`, env `FIRECRAWL_API_KEY`, comment (глубокое чтение/обход; ПРИНЯТ; MIT).
  Все три ПРИНЯТ (`docs/research/research-vet.md`). Существующие блоки не трогать. JSON валиден.

---

## Безопасность правки (floor-safe)

- **Бэкап** — Step 2 `cp -n` (байт-в-байт ОС, не LLM-память; идемпотентно). gitignored Step 1.
- **Валидация JSON** — программный `node -e JSON.parse` пол блокирует (правило 8), поэтому floor-safe:
  (а) пост-Edit Read `.mcp.json` + структурная сверка (3 блока, скобки/запятые целы);
  (б) MCP-серверы валидируют JSON при загрузке после перезапуска (битый JSON → серверы не стартуют — заметно сразу).
- **Откат** — из бэкапа: `cp .mcp.json.bak-perplexity-pack-20260614 .mcp.json`; либо владелец `git checkout -- .mcp.json` (файл tracked). Правка аддитивная — риск минимален.

## Self-Review

- Покрытие: Task 3 → {#D3}. {#D2} (вет) сделан в plan-v6. {#D4}-{#D9} — Планы 2 и 3.
- Floor-safe: Edit/Write + `cp -n` (не arbitrary-exec, не destructive) → ни floor, ни Δ7+ не блокируют; escape не нужен.
- Бэкап байт-в-байт (cp, не память — закрывает замечание судьи к v7); идемпотентно (cp -n); gitignored.

## Примечания

- Перенос только ПРИНЯТ-пакетов (все три) из `docs/research/research-vet.md`.
- Ключи — user env, не в репо. Live-smoke — после переноса + перезапуска владельцем.
- Регрессия vitest + реестр/нормативка/роутер — Планы 2 и 3.
