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

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

**Goal:** Аддитивно перенести три АКТИВНЫХ блока серверов research-слоя в main `.mcp.json` floor-safe способом (проверка ключей, бэкап `cp -n`, gitignore бэкапа). Владелец выбрал активацию (Вариант 2), приняв денежный риск.

**Architecture:** Вет (research-vet.md) и дом-README уже на диске (plan-v6). Этот план — только перенос. Все операции floor-safe (Edit/Write + `echo`/`cp`). Серверы добавляются АКТИВНЫМИ (по решению владельца), ключи из user env.

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

## Цель

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

## Переговоры

**Позиция контроллера (против требования судьи о техническом cost-ceiling).** Перенос
конфигурации сам по себе тратит **$0** — деньги идут ТОЛЬКО при явном вызове tool
(perplexity_ask / web_search_exa / firecrawl_scrape) ПОСЛЕ перезапуска, что под контролем
контроллера, а не автономно. Владелец **явно принял денежный риск** и выбрал активацию
(Вариант 2), сознательно отклонив DEFERRED (Вариант 1) и отдельную стройку consent-gate
(Вариант 3). Технического cost-ceiling на уровне MCP не существует; реальные контроли —
дисциплина исполнителя (точечно, без автономных циклов) + механизм deferred-tools (схемы
грузятся по запросу) + явная пометка bulk-load-риска. Требование «технический барьер»
невыполнимо в рамках задачи «перенос конфига» без Варианта 3, от которого владелец отказался.
**Прошу эскалацию к владельцу** для разрешения конфликта судья↔контроллер.

## Платные API — предупреждение (cost)

Три сервера — платные (Perplexity sonar-* / Exa / Firecrawl). Расхода при переносе/загрузке
НЕТ; деньги — только при явном вызове tool. Использовать точечно, без автономных циклов.

```skills-json
[]
```

```steps-json
[
  {"op":"Bash","object":"echo \"keys: PERPLEXITY=${PERPLEXITY_API_KEY:+set} EXA=${EXA_API_KEY:+set} FIRECRAWL=${FIRECRAWL_API_KEY:+set}\"","ref":"D3"},
  {"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/research/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: Проверка наличия ключей (без утечки)** — Run: `echo "keys: PERPLEXITY=${PERPLEXITY_API_KEY:+set} EXA=${EXA_API_KEY:+set} FIRECRAWL=${FIRECRAWL_API_KEY:+set}"` — Expected: `keys: PERPLEXITY=set EXA=set FIRECRAWL=set`.
- [ ] **Step 2: Защитить бэкап в .gitignore** — Read `.gitignore`, Edit: добавить `.mcp.json.bak-*`, если нет.
- [ ] **Step 3: Байт-в-байт бэкап** — Run: `cp -n .mcp.json .mcp.json.bak-perplexity-pack-20260614`.
- [ ] **Step 4: Добавить три АКТИВНЫХ блока** — Read `.mcp.json`, Edit: перед `_disabled_marketing_servers_note` добавить активные `mcpServers` `perplexity`/`exa`/`firecrawl` (по образцу `openapi`/`sentry`; env через `${VAR}`; comment с вердиктом вета ПРИНЯТ + «платный»). Существующие блоки не трогать. JSON валиден.

---

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

- Ключи — Step 1 (`:+set`, без утечки). Бэкап — Step 3 `cp -n` (байт-в-байт, идемпотент), gitignored Step 2.
- Валидация — пост-Edit Read + загрузка MCP при перезапуске. Откат — из бэкапа / `git checkout` (владелец).

## Self-Review

- Покрытие: Task 3 → {#D3}. Floor-safe (Edit/Write + echo/cp).
- Раздел «Переговоры» несёт позицию контроллера для карточки арбитража (судья↔контроллер по cost).

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

- Перенос ПРИНЯТ-пакетов (все три) из `docs/research/research-vet.md`. Live-smoke — после перезапуска.
